获取流量信息

请求

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

URI 参数

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

请求头

请求标头	说明
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-01T16:00:00Z",
      "VolumeInMB": 100,
      "OriginVolumeInMB": 20
    },
    {
      "Timestamp": "2017-05-02T16:00:00Z",
      "VolumeInMB": 200,
      "OriginVolumeInMB": 40
    }
  ],
  "TotalCdnVolumeInMB": 300,
  "TotalOriginVolumeInMB": 60
}

参数名称	描述
DomainName	加速域名
VolumeInMB	CDN 流量
OriginVolumeInMB	回源流量
TotalCdnVolumeInMB	CDN 总流量
TotalOriginVolumeInMB	回源总流量

请求失败的 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：请求中止
消息	错误信息