获取订阅下所有节点流量信息

  • Article

请求

方法 请求 URI
GET https://restapi.cdn.azure.cn/subscriptions/{subscriptionId}/endpoints/{endpointId}/volume?apiVersion=1.0

URI参数

参数名 描述
subscriptionId 订阅唯一标识
endpointId 目标节点唯一标识
startTime 流量查询起始时间，必须符合'yyyy-MM-ddTHH:mm:ssZ’格式的UTC时间
endTime 流量查询结束时间，必须符合'yyyy-MM-ddTHH:mm:ssZ’格式的UTC时间
granularity 流量统计粒度。
  • PerFiveMinutes:按五分钟
  • PerHour：按小时
  • PerDay：按天

请求 Headers

请求包头 描述
x-azurecdn-request-date 必填。符合yyyy-MM-dd HH:mm:ss格式的UTC当前请求时间
Authorization 必填。授权头请参考CDN API签名机制

请求 Body

无

响应

响应由状态码，响应 headers以及响应 body组成。

状态码

状态码 描述
200 表明服务器成功返回
其他 表示出错的通用回复

响应 Headers

响应包头 描述
X-Correlation-Id 该请求唯一标识，用于追踪请求信息。

响应 Body

请求成功的JSON示例:：

{
  "Details": {
    "www.example1.com": {
      "DomainName": "www.example1.com",
      "Items": [
        {
          "Timestamp": "2017-05-01T16:00:00Z",
          "VolumeInMB": 100,
          "OriginVolumeInMB": 20
        },
        {
          "Timestamp": "2017-05-02T16:00:00Z",
          "VolumeInMB": 200,
          "OriginVolumeInMB": 40
        }
      ],
      "TotalCdnVolumeInMB": 300,
      "TotalOriginVolumeInMB": 60
    },
    "www.example2.com": {
      "DomainName": "www.example2.com",
      "Items": [
        {
          "Timestamp": "2017-05-01T16:00:00Z",
          "VolumeInMB": 100,
          "OriginVolumeInMB": 20
        },
        {
          "Timestamp": "2017-05-02T16:00:00Z",
          "VolumeInMB": 200,
          "OriginVolumeInMB": 40
        }
      ],
      "TotalCdnVolumeInMB": 300,
      "TotalOriginVolumeInMB": 60
    },
  "TotalCdnVolumeInMB": 600,
  "TotalOriginVolumeInMB": 120
}
参数名称 描述
DomainName 加速域名
VolumeInMB CDN流量
OriginVolumeInMB 回源流量
TotalCdnVolumeInMB CDN总流量
TotalOriginVolumeInMB 回源总流量

请求失败的JSON示例:

{
  "Succeeded": false,
  "ErrorInfo": {
    "Type": "MissingAuthorizationHeader",
    "Message": "Missing authorization header."
  }
}
参数名称 描述
Type 错误类型
  • CredentialInvalid:凭据不合法
  • ParameterMissing:缺少参数
  • ParameterInvalid：参数不合法
  • MissingAuthorizationHeader:缺少Authorization请求头
  • InvalidRequestDateHeader:请求时间不合法
  • MissingRequestDateHeader：缺少请求时间头
  • AuthorizationHeaderExpired:Authorization请求头已失效
  • InvalidAuthorizationHeader:Authorization请求头不合法
  • ApiKeyNotFound：API密钥不存在
  • InvalidApiKey:API密钥不合法
  • WrongSignature:签名不对
  • SubscriptionNotFound：订阅不存在
  • EndpointDoesNotBelongToSubscription：节点不属于订阅
  • EndpointNotInActiveState：节点不处于活跃状态
  • EndpointNotFound：节点不存在
  • MaliciousItemPathDetected：检查到恶意路径
  • PermissionDenied：权限不够
  • RequestThrottled：请求被限流
Message 错误信息