最近更新时间:2023.09.06 11:03:29
首次发布时间:2022.12.29 10:10:01
API 名称:DescribeCdnOriginData
API 域名:open.volcengineapi.com
API 描述:查询回源请求的统计数据。回源请求是 CDN 节点向源站发起的请求。
POST
在调用该 API 时,您在请求中必须包含公共参数。在这些公共参数中,以下两个查询参数的取值说明如下:
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
Action | String | 是 | API 的名称。该参数的取值是 DescribeCdnOriginData 。 | DescribeCdnOriginData |
Version | String | 是 | API 的版本。该参数的取值是 2022-03-01 。 | 2022-03-01 |
参数名称 | 数据类型 | 是否必选 | 参数说明 | 示例 |
---|---|---|---|---|
StartTime | Integer | 是 | 指定一个时间段的起点,查询该时间段内(包含起点)的数据。使用时间戳表示,单位为秒。 时间段按照您设置的 Interval 值向前规整。示例:假设 Interval 为 5 分钟(对应秒级时间戳 300),那么 1644163200 和 1644163499 都会规整为 1644163200。 | 1668789300 |
EndTime | Integer | 是 | 指定一个时间段的终点,查询该时间段内(不包含终点)的数据。使用时间戳表示,单位为秒。 时间段按照您设置的 Interval 值向前规整。示例:假设 Interval 为 5 分钟(对应秒级时间戳 300),那么 1644163200 和 1644163499 都会规整为 1644163200。 | 1668790200 |
Metric | String | 是 | 指定一个要查询的指标。该参数有以下取值:
| flux |
Interval | String | 否 | 指定返回数据的时间间隔。该参数有以下取值:
| 5min |
Domain | String | 否 | 指定一个或多个域名,查询对应域名的数据。多个域名间使用半角逗号(,)分隔。最多允许设置 10 个域名。
| a.example.com,b.example.com |
DomainId | String | 否 | 指定一个或多个域名的 ID,查询对应域名的数据。多个域名 ID 间使用半角逗号(,)分隔。最多允许设置 10 个域名 ID。
| 63aa6f9a0708929612b2**** |
CloudAccountId | String | 否 | 指定一个或多个云服务商的账号 ID,查询对应云服务商账号的数据。多个账号 ID 间使用半角逗号(,)分隔。
| 6376e8be0b2233bf5431**** |
Aggregate | String | 否 | 查询多个域名、域名 ID、云服务商账号的数据时,设置返回数据的类型。该参数有以下取值:
| disaggregate |
参数名称 | 数据类型 | 参数说明 | 示例 |
---|---|---|---|
Resources | ResourceStatData[] | 查询到的数据明细。 | |
VendorsMetaData | VendorMetaData[] | 多云CDN向云服务商发起的查询请求的相关信息。 |
POST open.volcengineapi.com?Action=DescribeCdnOriginData&Version=2022-03-01&<其他公共请求参数> { "StartTime": 1668789300, "EndTime": 1668790200, "Metric": "flux", "CloudAccountId": "637721841cb67659c3eb****" }
{ "ResponseMetadata": { "RequestID": "20221228114541AF4F0FCCFD75B2824E68", "Action": "DescribeCdnOriginData", "Version": "2022-03-01", "Service": "mcdn", "Region": "cn-north-1" }, "Result": { "Resources": [ { "Name": "total", "Metrics": [ { "Metric": "flux", "Values": [ { "Timestamp": 1668789300, "Value": 2809704 }, { "Timestamp": 1668789600, "Value": 2965136 }, { "Timestamp": 1668789900, "Value": 2786385 } ] } ] } ], "VendorsMetaData": [ { "Vendor": "huawei", "RequestId": "f5d0adcd31149a2d396aaa09ffb14304", "Cost": 269.044 } ] } }
如果响应正文的 ResponseMetadata
字段中包含 Error
字段,则表示 API 请求失败。关于更多错误码的信息,参见错误码。