DescribeDomainPathData_内容分发_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 该接口仅支持白名单用户(域名峰值带宽 10 Gbps 以上)调用,需要提交工单申请,符合条件的情况下将在后台进行配置。
  • 单用户调用频率:6000 次/分。
  • 目前仅支持对账号下的指定域名开启目录维度带宽统计,不支持对全部域名开启。
  • 域名下所有文件的平均大小需要大于 1 MB。
  • 每个域名的目录数量不超过 100 个,超过 100 个目录的情况下,数据的精度将会降低,查询的不准确。
  • 不指定 StartTime 和 EndTime 时,默认读取过去 24 小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。
  • 最多可获取最近 30 天的数据。

流控信息

请求速率为10/1(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
cdn:DescribeDomainPathData
Get
Domain
acs:cdn:*:{#accountId}:domain/{#DomainName}

请求参数

字段名称字段详情
PageNumberinteger<int32>

取得第几页。从 1 开始。

示例值:1取值 >= 1
PageSizeinteger<int32>

分页大小。展开详情

示例值:20取值 <= 1000
Pathstring

路径,以正斜线(/)开头,不填表示查询所有路径。如果路径是目录,需要以正斜线(/)结尾。展开详情

示例值:/path/
StartTimestring

开始时间,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-DDThh:mm:ssZ。展开详情

示例值:2016-10-20T04:00:00Z
EndTimestring

结束时间,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-DDThh:mm:ssZ。开始时间和结束时间,间隔小于 30 天。例如:2016-10-21T04:00:00Z。

示例值:2016-10-21T04:00:00Z
DomainNamestring

加速域名。展开详情

示例值:example.com参考取值来源:
    AddCdnDomain
    DescribeDomainQpsData
    BatchSetCdnDomainConfig
    SetCdnDomainStagingConfig
    ListRealtimeLogDeliveryDomains

返回参数

字段名称字段详情
EndTimestring

结束时间。

示例值:2017-09-30T17:00:00Z
StartTimestring

开始时间。

示例值:2017-09-30T16:00:00Z
PageSizeinteger<int32>

页面大小。

示例值:20
PageNumberinteger<int32>

当前页码,从 1 开始计数。

示例值:1
TotalCountinteger<int32>

路径带宽数据条数。

示例值:2
DomainNamestring

加速域名。

示例值:example.com
DataIntervalstring

时间间隔,单位:秒。

示例值:300
PathDataPerIntervalobject
RequestIdstring

请求 ID。

示例值:DE81639B-DAC1-4C76-AB72-F34B836837D5

返回示例

错误返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidPageSize.Malformed
PageSize must be of type Integer诊断
400
InvalidPageSize.ExceedsMaximum
PageSize should be less than or equal to 1000诊断
400
InvalidPageSize.ExceedsMinimum
PageSize should be greater than or equal to 1诊断
400
InvalidPath.Malformed
Path must be of type String诊断
400
InvalidStartTime.Malformed
StartTime must be of type String诊断
400
InvalidEndTime.Malformed
EndTime must be of type String诊断
400
InvalidDomainName.Malformed
DomainName must be of type String诊断
400
MissingParameter
DomainName is required诊断
400
InvalidDomainName.TooShort
DomainName should be at least 1 chars long诊断
400
InvalidPageNumber.Malformed
PageNumber must be of type Integer诊断
400
InvalidPageNumber.ExceedsMinimum
PageNumber should be greater than or equal to 1诊断
400
InvalidTime.OverRange
Specified StartTime or EndTime is over range诊断

变更历史

变更时间变更内容概要操作
2024-12-20
变更返回参数
2024年08月20日