请求
| 方法
| 请求 URI
|
|---|
| GET |
https://restapi.cdn.azure.cn/subscriptions/{subscriptionId}/endpoints/{endpointId}/bandwidth?apiVersion=1.0 |
URI 参数
| 参数名称
| 描述
|
|---|
| subscriptionId |
订阅唯一标识符 |
| endpointId |
目标节点唯一标识符 |
| startTime |
带宽查询起始时间，必须是符合“yyyy-MM-ddTHH:mm:ssZ”格式的 UTC 时间。 |
| endTime |
带宽查询结束时间，必须是符合“yyyy-MM-ddThh:mm:ssZ”格式的 UTC 时间。 |
| 请求标头 |
说明 |
| x-azurecdn-request-date |
必需。 以 yyyy-MM-dd hh:mm:ss 格式输入当前 UTC 请求时间。 |
| 授权 |
必需。 有关授权标头，请参阅 CDN API 签名机制。 |
请求正文
无
响应
响应包括状态代码、响应头和响应正文。
状态代码
| 状态代码
| 描述
|
|---|
| 200 |
指示服务器已成功返回响应。 |
| 其他 |
指示发生错误的一般响应。 |
| 响应头
|
描述
|
|---|
| X-Correlation-Id |
请求的唯一标识符，用于跟踪请求信息。 |
响应正文
请求成功的 JSON 示例：
{
"DomainName": "www.example.com",
"Items": [
{
"Timestamp": "2017-05-02T00:00:00Z",
"BandwidthInMbps": 100,
"OriginBandwidthInMbps": 20
,
{
"Timestamp": "2017-05-02T00:00:05Z",
"BandwidthInMbps": 80,
"OriginBandwidthInMbps": 60
},
{
"Timestamp": "2017-05-02T00:00:10Z",
"BandwidthInMbps": 120,
"OriginBandwidthInMbps": 10
}
],
"PeakBandwidthInMbps": 120,
"ValleyBandwidthInMbps": 80,
"PeakOriginBandwidthInMbps": 60,
"ValleyOriginBandwidthInMbps": 10
}
| 参数名称
| 描述
|
|---|
| PeakBandwidthInMbps |
CDN 带宽峰值 |
| ValleyBandwidthInMbps |
CDN 带宽谷值 |
| PeakOriginBandwidthInMbps |
回源带宽峰值 |
| ValleyBandwidthInMbps |
回源带宽谷值 |
请求失败的 JSON 示例：
{
"Succeeded": false,
"ErrorInfo": {
"Type": "MissingAuthorizationHeader",
"Message": "Missing authorization header."
}
}
| 参数名称
| 描述
|
|---|
| 类型 |
错误类型
- CredentialInvalid：凭据无效
- ParameterMissing：参数缺失
- ParameterInvalid：参数无效
- MissingAuthorizationHeader：授权标头缺失
- InvalidRequestDateHeader：请求日期标头无效
- MissingRequestDateHeader：请求日期标头缺失
- AuthorizationHeaderExpired：授权标头过期
- InvalidAuthorizationHeader：授权标头无效
- ApiKeyNotFound：找不到 API 密钥
- InvalidApiKey：API 密钥无效
- WrongSignature：签名错误
- SubscriptionNotFound：订阅不存在
- EndpointDoesNotBelongToSubscription：终结点不属于订阅
- EndpointNotInActiveState：终结点未处于活跃状态
- EndpointNotFound：终结点不存在
- MaliciousItemPathDetected：检测到恶意项路径
- PermissionDenied：权限不足
- RequestThrottled：请求中止
|
| 消息 |
错误信息 |