913
阿里云
查询回源带宽__资源监控接口_API 手册_CDN-阿里云
描述
获取加速域名的回源带宽监控数据,单位 bit/second
不指定StartTime和EndTime时,默认读取过去24小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。
- 支持批量域名查询,多个域名用逗号(半角)分隔
- 最多可获取最近90天的数据
请求参数
参数 | 类型 | 必要 | 描述 |
---|---|---|---|
Action | String | 是 | 操作接口名,系统规定参数 取值:DescribeDomainSrcBpsData |
DomainName | String | 否 | 若参数为空,默认返回所有加速域名合并后数据 可输入需要查询的加速域名 支持批量域名查询,多个域名用逗号(半角)分隔,若需要查询全部域名数据 |
StartTime | String | 否 | 获取数据起始时间点,日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mmZ 最小数据粒度为5分钟 不写默认读取过去24小时数据 |
EndTime | String | 否 | 结束时间需大于起始时间;获日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mmZ |
返回参数
名称 | 类型 | 描述 |
---|---|---|
DomainName | String | 加速域名信息 |
DataInterval | String | 每条记录的时间间隔,以秒为单位 |
StartTime | DateTime | 开始时间 |
EndTime | DateTime | 结束时间 |
SrcBpsDataPerInterval | UsageData[] | 每个时间间隔的回源带宽数据 |
UsageData
名称 | 类型 | 描述 |
---|---|---|
TimeStamp | String | 时间片起始时刻 |
Vaule | String | 详细使用数据 |
特殊错误码
错误代码 | 描述 | Http 状态码 | 语义 |
---|---|---|---|
Throttling | Request was denied due to request throttling. | 503 | 请求被流量控制限制 |
IllegalOperation | Illegal domain, operation is not permitted. | 403 | 非法域名, 无法操作 |
OperationDenied | Your account does not open CDN service yet. | 403 | 未开通CDN服务 |
OperationDenied | Your CDN service is suspended. | 403 | CDN服务已被停止 |
InvalidDomain.NotFound | The domain provided does not belong to you. | 404 | 域名不存在或不属于当前用户 |
InvalidDomain.Offline | The domain provided is offline. | 404 | 域名已下线 |
ServiceBusy | The specified Domain is configuring, please retry later. | 403 | 域名正在配置中, 请稍后再试 |
InvalidDomain.Configure_failed | Failed to configure the provided domain. | 500 | 域名配置失败 |
MissingParameter | StartTime and EndTime can not be single. | 400 | StartTime和EndTime不能单独设置 |
InvalidStartTime.Malformed | Specified start time is malformed. | 400 | StartTime格式错误 |
InvalidEndTime.Malformed | Specified end time is malformed. | 400 | EndTime格式错误 |
InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 400 | EndTime小于StartTime |
InvalidStartTime.ValueNotSupported | Specified end time does not math the specified start time. | 400 | EndTime和StartTime差值超过90天 |
示例
请求示例:
https://cdn.aliyuncs.com?Action=DescribeDomainSrcBpsData&DomainName=test.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&<公共请求参数>
返回示例:
JSON格式
{
"DomainName": "test.com",
"DataInterval": "300",
"SrcBpsDataPerInterval": {
"DataModule": [
{
"TimeStamp": "2015-12-10T21:00:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:35:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:50:00Z",
"Value": "821"
},
{
"TimeStamp": "2015-12-10T20:05:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:10:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:55:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:30:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:25:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:00:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:40:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:15:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:45:00Z",
"Value": "0"
},
{
"TimeStamp": "2015-12-10T20:20:00Z",
"Value": "0"
}
]
},
"RequestId": "7CBCD6AD-B016-42E5-AE0B-B3731DE8F755",
"StartTime": "2015-12-10T20:00Z",
"EndTime": "2015-12-10T21:00Z"
}
XML格式:
<?xml version="1.0" ?>
<DescribeDomainSrcBpsDataResponse>
<SrcBpsDataPerInterval>
<DataModule>
<TimeStamp>2015-12-10T20:00:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:05:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:10:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:15:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:20:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:25:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:30:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:35:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:40:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:45:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:50:00Z</TimeStamp>
<Value>821</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:55:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T21:00:00Z</TimeStamp>
<Value>0</Value>
</DataModule>
</SrcBpsDataPerInterval>
<DataInterval>300</DataInterval>
<RequestId>0B90BD21-0878-4FD9-9DD1-3F68DD0036F4</RequestId>
<DomainName>test.com</DomainName>
<EndTime>2015-12-10T21:00Z</EndTime>
<StartTime>2015-12-10T20:00Z</StartTime>
</DescribeDomainSrcBpsDataResponse>
最后更新:2016-11-23 17:16:03
上一篇:
查询流量数据__资源监控接口_API 手册_CDN-阿里云
下一篇:
查询回源流量__资源监控接口_API 手册_CDN-阿里云
常见错误说明__附录_大数据计算服务-阿里云
发送短信接口__API使用手册_短信服务-阿里云
接口文档__Android_安全组件教程_移动安全-阿里云
运营商错误码(联通)__常见问题_短信服务-阿里云
设置短信模板__使用手册_短信服务-阿里云
OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
消息通知__操作指南_批量计算-阿里云
设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云