全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
CDN

查询域名路径级别的监控数据

更新时间:2017-12-25 10:51:20

DescribeDomainPathData

描述

获取加速域名路径级别的5分钟维度的监控数据, 包括流量和访问次数.

  • 不指定StartTime和EndTime时,默认读取过去24小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。
  • 不支持批量域名查询
  • 最多可获取最近30天的数据
  • 路径信息不支持模糊匹配

请求参数

参数 类型 必须 描述
Path String 路径,以/开头,不填表示查询所有路径;如果路径是目录,需要以/结尾
StartTime String 开始时间, 日期格式按照ISO8601表示法,并使用UTC时间。例如:2016-10-20T04:00:00Z
EndTime String 结束时间, 日期格式按照ISO8601表示法,并使用UTC时间。起止时间和结束时间,间隔小于30天;例如:2016-10-20T04:00:00Z
DomainName String 域名
PageNumber Integer 页号,从1开始
PageSize Integer 每页大小, 不超过1000

返回参数

参数 类型 描述
PathDataPerInterval UsageData[] 路径带宽数据列表
PageNumber Integer 当前页码,从1开始计数
PageSize Integer 页大小
TotalCount Integer 路径带宽数据条数
StartTime String 起始时间
EndTime String 结束时间
DataInterval Integer 时间间隔,单位:秒

数据类型 UsageData

参数 类型 描述
Time String 时间点
Acc Integer 访问次数
Traffic Integer 流量(B)
Path String 路径

特定错误码

ErroCode 错误码 Message 错误信息 HTTP 返回码 语义
OperationDenied Your account does not open CDN service yet. 403 当前账户未开通CDN服务
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 域名不存在或不属于当前用户
InvalidDomainName.NotFound Your domain is on our recodes 404 域名不存在
MissingParameter DomainName is required 400 DomainName 缺失
InvalidDomainName.TooShort DomainName should be at least 1 chars long 400 DomainName 至少1个字符
InvalidPageNumber.ExceedsMinimum PageNumber should be greater than or equal to 1 400 PageNumber 应大于等于 1
InvalidPageSize.ExceedsMaximum PageSize should be less than or equal to 1000 400 PageSize 应小于等于 1000
InvalidPageSize.ExceedsMinimum PageSize should be greater than or equal to 1 400 PageSize 应大于等于 1
InvalidTime.OverRange Specified StartTime or EndTime is over range 400 起始时间、结束时间或二者之差超出允许范围

示例

请求示例

  1. https://cdn.aliyuncs.com?Action=DescribeDomainPathData&DomainName=<DomainName>&PageNumber=1&PageSize=20

响应示例

  • JSON格式
  1. {
  2. "DataInterval": 300,
  3. "EndTime": "2017-09-30T17:00:00Z",
  4. "PageNumber": 1,
  5. "PageSize": 20,
  6. "PathDataPerInterval": {
  7. "UsageData": [
  8. {
  9. "Acc": 10,
  10. "Path": "/path/",
  11. "Time": "2017-09-30T16:00:00Z",
  12. "Traffic": 346
  13. },
  14. {
  15. "Acc": 12,
  16. "Path": "/path/",
  17. "Time": "2017-09-30T16:05:00Z",
  18. "Traffic": 400
  19. }
  20. ]
  21. },
  22. "StartTime": "2017-09-30T16:00:00Z",
  23. "TotalCount": 2
  24. }
  • XML格式
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <DescribeDomainPathDataResponse>
  3. <TotalCount>2</TotalCount>
  4. <StartTime>2017-09-30T16:00:00Z</StartTime>
  5. <EndTime>2017-09-30T17:00:00Z</EndTime>
  6. <DataInterval>300</DataInterval>
  7. <PathDataPerInterval>
  8. <UsageData>
  9. <Acc>10</Acc>
  10. <Path>/path/</Path>
  11. <Time>2017-09-30T16:00:00Z</Time>
  12. <Traffic>346</Traffic>
  13. </UsageData>
  14. <UsageData>
  15. <Time>2017-09-30T16:05:00Z</Time>
  16. <Traffic>400</Traffic>
  17. <Acc>12</Acc>
  18. <Path>/path/</Path>
  19. </UsageData>
  20. </PathDataPerInterval>
  21. <PageNumber>1</PageNumber>
  22. <PageSize>20</PageSize>
  23. </DescribeDomainPathDataResponse>
本文导读目录