如何查询网络带宽?
DescribeDomainBpsData
描述
获取加速域名的网络带宽监控数据，单位bit/second
不指定StartTime和EndTime时，默认读取过去24小时的数据，同时支持按指定的起止时间查询，两者需要同时指定。
- 支持批量域名查询，多个域名用逗号（半角）分隔
- 最多可获取最近90天的数据
请求参数
| 参数 | 类型 | 必要 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数取值：DescribeDomainBpsData |
| DomainName | String | 否 | 若参数为空，默认返回所有加速域名合并后数据可输入需要查询的加速域名支持批量域名查询，多个域名用逗号（半角）分隔 |
| StartTime | String | 否 | 获取数据起始时间点，日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mmZ最小数据粒度为5分钟不写默认读取过去24小时数据 |
| EndTime | String | 否 | 结束时间需大于起始时间；获日期格式按照ISO8601表示法，并使用UTC时间。格式为：YYYY-MM-DDThh:mmZ |
| Time Merge | String | 否 | 取值范围 on：默认值，每条记录的时间间隔会根据时间跨度做合并；off：返回5分钟粒度数据，最大时间跨度为31天 |
| Interval | String | 否 | 查询数据的时间粒度，支持300, 3600, 14400, 28800和86400秒。不传和传的值不支持时，使用默认值300秒 |
| LocationNameEn | String | 否 | 区域英文名，通过DescribeCdnRegionAndIsp接口获得，不传为所有区域 |
| IspNameEn | String | 否 | 运营商英文名，通过DescribeCdnRegionAndIsp接口获得，不传为所有运营商 |
| DomainType | String | 否 | 查询类型，传dynamic时，查询全站加速动态资源的实时带宽和静态资源的实时带宽。不传时查询静态资源的实时带宽 |
返回参数
| 名称 | 类型 | 描述 |
| DomainName | String | 加速域名信息 |
| DataInterval | String | [需要补充时间间隔规则]每条记录的时间间隔，以秒为单位 |
| StartTime | DateTime | 开始时间 |
| EndTime | DateTime | 结束时间 |
| BpsDataPerInterval | UsageData[] | 每个时间间隔的网络带宽数据 |
| SupplyBpsDatas | UsageData[] | 补充最近30分钟内参考实时带宽数据，可能不存在 |
UsageData
| 名称 | 类型 | 描述 |
| TimeStamp | String | 时间片起始时刻 |
| Value | String | bps数据值，单位：bit/second |
| DomesticValue | String | 国内带宽bps，当按区域运营商查询时，此值为空 |
| OverseasValue | String | 海外带宽bps，当按区域运营商查询时，此值为空 |
| L2Value | String | L2 bps数据值，单位：bit/second |
| DomesticL2Value | String | L2国内带宽bps，当按区域运营商查询时，此值为空 |
| OverseasL2Value | String | L2海外带宽bps，当按区域运营商查询时，此值为空 |
| DynamicValue | String | 全站加速，动态bps数据值，单位：bit/second |
| DynamicDomesticValue | String | 全站加速，国内带宽动态bps，当按区域运营商查询时，此值为空 |
| DynamicOverseasValue | String | 全站加速，海外带宽动态bps，当按区域运营商查询时，此值为空 |
| StaticValue | String | 全站加速，静态bps数据值，单位：bit/second |
| StaticDomesticValue | String | 全站加速，国内带宽静态bps，当按区域运营商查询时，此值为空 |
| StaticOverseasValue | String | 全站加速，海外带宽静态bps，当按区域运营商查询时，此值为空 |
特殊错误码
| 错误代码 | 描述 | 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天 |
| InvalidTime Merge.ValueNotSupported | When value of parameter Time Merge is off, maximum time interval is 31 days. | 400 | 当Time Merge为off时，最大时间跨度为31天 |
示例
请求示例：
http://cdn.aliyuncs.com?Action=DescribeDomainBpsData&DomainName=test.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&<公共请求参数>
返回示例：
JSON格式
{
"BpsDataPerInterval": {
"DataModule": [
{
"TimeStamp": "2015-12-10T20:00:00Z",
"Value": "11288111",
"DomesticValue": "11286111",
"OverseasValue": "2000",
"L2Value": "0",
"DomesticL2Value": "0",
"OverseasL2Value": "0",
"DynamicValue": "0",
"DynamicDomesticValue": "0",
"DynamicOverseasValue": "0",
"StaticValue": "0",
"StaticDomesticValue": "0",
"StaticOverseasValue": "0"
},
{
"TimeStamp": "2015-12-10T20:05:00Z",
"Value": "12124821",
"DomesticValue": "12112821",
"OverseasValue": "12000",
"L2Value": "0",
"DomesticL2Value": "0",
"OverseasL2Value": "0",
"DynamicValue": "0",
"DynamicDomesticValue": "0",
"DynamicOverseasValue": "0",
"StaticValue": "0",
"StaticDomesticValue": "0",
"StaticOverseasValue": "0"
}
]
},
"SupplyBpsDatas": {
"DataModule": [
{
"TimeStamp": "2015-12-10T20:05:00Z",
"Value": "12124821"
},
{
"TimeStamp": "2015-12-10T20:06:00Z",
"Value": "12144838"
}
]
},
"DomainName": "test.com",
"DataInterval": "300",
"RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
"StartTime": "2015-12-10T20:00Z",
"EndTime": "2015-12-10T21:00Z"
}
XML格式：
<?xml version="1.0" ?>
<DescribeDomainBpsDataResponse>
<DataInterval>300</DataInterval>
<BpsDataPerInterval>
<DataModule>
<TimeStamp>2015-12-10T21:00:00Z</TimeStamp>
<Value>11431540</Value>
<DomesticValue>11131540</DomesticValue>
<OverseasValue>300000</OverseasValue>
<L2Value>0</L2Value>
<DomesticL2Value>0</DomesticL2Value>
<OverseasL2Value>0</OverseasL2Value>
<DynamicValue>0</DynamicValue>
<DynamicDomesticValue>0</DynamicDomesticValue>
<DynamicOverseasValue>0</DynamicOverseasValue>
<StaticValue>0</StaticValue>
<StaticDomesticValue>0</StaticDomesticValue>
<StaticOverseasValue>0</StaticOverseasValue>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:35:00Z</TimeStamp>
<Value>12793665</Value>
<DomesticValue>12791665</DomesticValue>
<OverseasValue>2000</OverseasValue>
<L2Value>0</L2Value>
<DomesticL2Value>0</DomesticL2Value>
<OverseasL2Value>0</OverseasL2Value>
<DynamicValue>0</DynamicValue>
<DynamicDomesticValue>0</DynamicDomesticValue>
<DynamicOverseasValue>0</DynamicOverseasValue>
<StaticValue>0</StaticValue>
<StaticDomesticValue>0</StaticDomesticValue>
<StaticOverseasValue>0</StaticOverseasValue>
</DataModule>
</BpsDataPerInterval>
<SupplyBpsDatas>
<DataModule>
<TimeStamp>2015-12-10T20:35:00Z</TimeStamp>
<Value>12793665</Value>
</DataModule>
<DataModule>
<TimeStamp>2015-12-10T20:36:00Z</TimeStamp>
<Value>19011526</Value>
</DataModule>
</SupplyBpsDatas>
<RequestId>AA2981FF-1A30-4590-B929-88FC85E12A8B</RequestId>
<DomainName>test.com</DomainName>
<EndTime>2015-12-10T21:00Z</EndTime>
<StartTime>2015-12-10T20:00Z</StartTime>
</DescribeDomainBpsDataResponse>
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答
问答排行榜
最热
最新
相关课程
更多
推荐问答
相关文章
相关电子书
更多
