查询访问日志--多云CDN-火山引擎

文档中心

立即注册

导航

查询访问日志

最近更新时间：2024.10.16 10:12:00首次发布时间：2024.10.16 10:12:00

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

使用说明

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

接口说明

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

只设置请求参数 DomainId：
DomainId 是多云CDN为每个同步到多云CDN的加速域名分配的唯一 ID。选择此方式时，不能设置 Domain、Vendor 和 SubProduct，否则请求会失败。
同时设置请求参数 Domain、Vendor 和 SubProduct。
由这 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	否	指定要查询的加速域名。说明 `Domain` 和 `DomainId` 不允许同时为空，否则日志查询请求会失败。如果您指定了 `Domain`，则必须同时指定 `Vendor` 和 `SubProduct`。	`www.example.com`
Vendor	String	否	指定一个云服务商，向该云服务商平台发起日志查询请求。说明如果您指定了 `Domain`，则必须同时指定 `Vendor` 和 `SubProduct`。该参数有以下取值： `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`，则不能指定 `Domain`、`Vendor` 和 `SubProduct`。	`654a58b930060dd533d3****`
SubProduct	String	否	指定一个产品类型。说明如果您指定了 `Domain`，则必须同时指定 `Vendor` 和 `SubProduct`。该参数有以下取值： `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 请求失败。关于更多错误码的信息，参见错误码。