最近更新时间:2023.12.27 21:13:09
首次发布时间:2023.07.19 15:18:25
此接口用域名等条件,获取一定时间范围内的命中率数据。
请求地址:https://vod.volcengineapi.com?Action=ListCdnHitrateData&Version=2022-01-01
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListCdnHitrateData | 接口名称。当前 API 的名称为 ListCdnHitrateData 。 |
Version | String | 是 | 2022-01-01 | 接口版本。当前 API 的版本为 2022-01-01 。 |
Domains | String | 是 | example.vod.com | 域名,多个用英文逗号 , 隔开。您可通过 ListDomain 接口获取指定空间下的域名列表。 |
Interval | String | 是 |
| 指定查询数据的时间粒度,单位为秒。取值如下:
|
StartTimestamp | Long | 否 | 1703174399 | 查询范围起始时间。Unix 时间戳,单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。默认当天 0 点。 |
EndTimestamp | Long | 否 |
| 查询范围截止时间。Unix 时间戳,单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。默认为第二天 0 点。 说明 最大支持单次查询 90 天的数据。 |
Metric | String | 是 |
| 指标类别。取值如下:
|
NeedDetail | Boolean | 否 |
| 是否需要详细数据。取值如下:
|
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Datas | Array of Datas | - | 数据列表。 |
NoPermissionDomains | Array of String | ["example.vod.com"] | 无权限域名列表。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Name | String | total | 统计目标名称。 |
Metric | String | hitrate | 指标类别。 |
DataType | String | 统计类别。 | |
Points | Array of Points | - | 打点数据。 |
Region | String | 国家或地区代码。 | |
Isp | String | 用户运营商。 | |
BillingRegion | String | 计费区域。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Timestamp | Double | 1703185200 | 时间戳。 |
Value | Double |
| 数值。 说明 该参数可能不存在,当不存在时则默认返回 0。 |
https://vod.volcengineapi.com?Action=ListCdnHitrateData&Version=2022-01-01
{ "ResponseMetadata": { "Region": "cn-north-1", "RequestId": "202306041104***100232280022D31", "Version": "2022-01-01", "Service": "vod", "Action": "ListCdnHitrateData" }, "Result": { "Datas": [ { "BillingRegion": "September", "DataType": "毛每或名原设西速", "Points": [ { "Value": 910, "Timestamp": 451 } ], "Isp": "bird", "Metric": "积土义圆明红共场大", "Region": "业派音何持法无参发", "Name": "上号长选组权" } ], "NoPermissionDomains": [ "few" ] } }
本接口无特有的错误码。更多信息请见公共错误码。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | InvalidParameter.InvalidDomains | - | 无效的 Domains。 |
400 | InvalidParameter.InvalidInterval | - | 无效的 Interval。 |
400 | InvalidParameter.InvalidMetric | - | 无效的 Metric。 |
点播 OpenAPI 提供了配套的服务端 SDK,支持多种编程语言,帮助您实现快速开发。建议使用服务端 SDK 来调用 API。此 API 各语言调用的示例代码,请参考如下: