You need to enable JavaScript to run this app.
导航
查询访问日志
最近更新时间:2024.10.16 10:12:00首次发布时间:2024.10.16 10:12:00

调用本接口向云服务商平台发起请求,查询指定加速域名的访问日志。

使用说明

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制

接口说明

本接口提供了以下两种指定加速域名的方式,您只能选择其中一种方式来指定要查询的加速域名:

  • 只设置请求参数 DomainId
    DomainId 是多云CDN为每个同步到多云CDN的加速域名分配的唯一 ID。选择此方式时,不能设置 DomainVendorSubProduct,否则请求会失败。
  • 同时设置请求参数 DomainVendorSubProduct
    由这 3 个参数值确定向哪个云服务商平台查询加速域名的访问日志。选择此方式时,这 3 个参数必须同时设置,否则请求会失败。

使用限制

节流限制:您每秒最多可以提交 20 个 API 请求。

请求说明

  • 请求方式:POST
  • 请求地址:https://open.volcengineapi.com/?Action=DescribeCdnAccessLog&Version=2022-03-01

请求参数

Query

参数名称
数据类型
是否必选
参数说明
Action
String
接口名称。当前 API 的名称为 DescribeCdnAccessLog
Version
String
接口版本。当前 API 的版本为 2022-03-01

Body

参数名称
数据类型
是否必选
参数说明
示例
StartTime
Long

指定一个时间段的起点,查询时间段内(包含起点)的日志。使用时间戳表示,单位为秒。

说明

不同云服务商平台允许查询的日志时间范围不同。若您设置的时间起点不符合云服务商平台的要求(超出最长可查询时间),那么日志查询请求会失败。更多信息,请参见日志查询限制

1728057600
EndTime
Long

指定一个时间段的终点,查询时间段内(不包含终点)的数据。使用时间戳表示,单位为秒。

说明

不同云服务商平台允许查询的日志时间跨度不同。若您设置的时间段不符合云服务商平台的要求(超出允许的时间跨度),那么日志查询请求会失败。更多信息,请参见日志查询限制

1728662400
Domain
String

指定要查询的加速域名。

说明

  • DomainDomainId 不允许同时为空,否则日志查询请求会失败。
  • 如果您指定了 Domain,则必须同时指定 VendorSubProduct
www.example.com
Vendor
String

指定一个云服务商,向该云服务商平台发起日志查询请求。

说明

如果您指定了 Domain,则必须同时指定 VendorSubProduct

该参数有以下取值:

  • builtin:内置加速
  • aliyun:阿里云
  • tencent:腾讯云
  • ksyun:金山云
  • huawei:华为云
  • volcengine:火山引擎
  • wangsu:网宿科技
  • qiniu:七牛云
  • ucloud:UCloud
  • akamai:Akamai
  • baishan:白山云
  • aws:AWS
  • baidu:百度智能云
  • jingdong:京东云
  • gcp:Google Cloud
  • chinamobile:中国移动
  • ctcdn:天翼云CDN+
  • azure:Azure
aliyun
DomainId
String

指定要查询的加速域名的 ID。

说明

  • 您可以调用 ListCdnDomains 接口查询所有加速域名的 ID。
  • 如果您指定了 DomainId,则不能指定 DomainVendor 和 SubProduct
654a58b930060dd533d3****
SubProduct
String

指定一个产品类型。

说明

如果您指定了 Domain,则必须同时指定 VendorSubProduct

该参数有以下取值:

  • cdn(默认):内容分发网络(CDN)
  • ucdn:UCloud UCDN
  • cloudfront:AWS CloudFront
  • amd:Akamai AMD
  • dsa:Akamai DSA
  • media_cdn:Google Cloud Media CDN
  • dcdn:全站加速(DCDN)
  • ecdn:腾讯云 ECDN
  • edgeone:腾讯云 EdgeOne
cdn
Pagination
Object
对查询结果进行分页并返回特定页码上的访问日志。

返回参数

参数名称
数据类型
参数说明
示例
Logs
Object[]
满足查询条件的访问日志。
Pagination
Object
分页信息。

请求示例

POST https://open.volcengineapi.com/?Action=DescribeCdnAccessLog&Version=2022-03-01
{
    "StartTime": 1728057600,
    "EndTime": 1728662400,
    "DomainId": "654a58b930060dd533d3****",
    "Pagination": {
        "PageSize": 10,
        "PageNum": 1
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "20241012141915DC7DA1CBFCD10DFFC039",
        "Action": "DescribeCdnAccessLog",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "Logs": [
            {
                "Domain": "www.example.com.com",
                "LogInfos": [
                    {
                        "Url": "cdnlog-sh-public.oss-cn-shanghai.aliyuncs.com/v1.l1cache/200027584/www.example.com.com/2024_10_05/www.example.com.com_2024_10_05_000000_010000.gz?Expires=1729318755&OSSAccessKeyId=LTAIviCc6zy8x3xa&Signature=********TdX9Xzj5rxDW%2BwLuAH8%3D",
                        "Size": 176774,
                        "FileName": "www.example.com.com_2024_10_05_000000_010000.gz",
                        "StartTime": 1728057600,
                        "EndTime": 1728061200
                    }
                ]
            }
        ],
        "Pagination": {
            "PageSize": 10,
            "PageNum": 1,
            "Total": 168
        },
        "VendorsMetaData": null
    }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段,则表示 API 请求失败。关于更多错误码的信息,参见错误码