调用GetBandwidthData获取加速域名的网络带宽监控数据,支持获取最近90天的数据。
说明
- 单位:bit/second。
- 不指定StartTime和EndTime时,默认读取过去24小时的数据;指定StartTime和EndTime时,按指定的起止时间查询。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetBandwidthData |
系统规定参数,取值:GetBandwidthData。 |
BusinessType | String | 是 | all |
业务类型,多个用竖线(|)分隔。取值:
|
EndDate | String | 是 | 2017-05-10 |
结束时间。 |
IspName | String | 是 | all |
运营商代码,多个用竖线(|)分隔,全部填all。 查询请参见通用字段参考。 |
PlatformType | String | 是 | all |
终端代码,多个用竖线(|)分隔,全部填all。 查询请参见通用字段参考。 |
Region | String | 是 | all |
地域代码,多个用竖线(|)分隔,全部填all。 查询请参见通用字段参考。 |
StartDate | String | 是 | 2017-05-01 |
开始时间。 |
Version | String | 是 | 2017-04-11 |
版本号。 |
Domain | String | 否 | all |
待查询的域名列表。支持批量域名查询,多个域名用竖线(|)分隔。 不传该参数将查询全部。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | Integer | 0 |
业务码,成功返回0。 |
DataList | Array of UsageData |
返回的信息列表。 |
|
UsageData | |||
Date | String | 2017-05-01 00:00:00 |
数据的时间片起始时刻。 |
Values | List | 95231540262 |
带宽数据,bit/second。 |
Labels | List | 带宽 |
标签,用于描述数据类型。 |
RequestId | String | 5C2C4882-69C3-45BA-A10E-67E4DFFEA403 |
请求ID。 |
示例
请求示例
http(s)://pcdn.aliyuncs.com/?Action=GetBandwidthData
&BusinessType=all
&EndDate=2017-05-10
&IspName=all
&PlatformType=all
&Region=all
&StartDate=2017-05-01
&Domain=all
&Version=2017-04-11
&<公共请求参数>
正常返回示例
XML
格式
<GetBandwidthDataResponse>
<Labels>带宽</Labels>
<RequestId>C86F7C0C-D520-4F67-95DB-277E9A233E4E</RequestId>
<DataList>
<UsageData>
<Values>
<Values>95231540262</Values>
<Values>290426020145</Values>
</Values>
<Date>2017-05-01 00:00:00</Date>
</UsageData>
<UsageData>
<Values>
<Values>36802763485</Values>
<Values>290426020145</Values>
</Values>
<Date>2017-05-01 04:00:00</Date>
</UsageData>
</DataList>
<Code>0</Code>
</GetBandwidthDataResponse>
JSON
格式
{
"Labels": "带宽" ,
"RequestId": "5C2C4882-69C3-45BA-A10E-67E4DFFEA403",
"DataList": {
"UsageData": [
{
"Values": {
"Values": [
95231540262,
290426020145
]
},
"Date": "2017-05-01 00:00:00"
},
{
"Values": {
"Values": [
36802763485,
290426020145
]
},
"Date": "2017-05-01 04:00:00"
}
]
},
"Code": 0
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter | You must specify domainName. | 请求中缺少必要的参数domainName |
访问错误中心查看更多错误码。