获取带宽信息

请求

方法 请求 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:请求中止

消息 错误信息