DescribeDcdnDomainUsageData_全站加速_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 次/秒
  • 用量数据包括流量、带宽和请求数三大类,单位分别为 Byte、bps 和次数。

支持查询的时间粒度

根据单次查询的最大时间跨度不同,请求参数 Interval 支持不同的查询数据时间粒度,对应的可查询历史数据时间范围和数据延迟如下:

时间粒度单次查询的最大时间跨度可查询历史数据时间范围数据延迟
5 分钟3 天93 天15 分钟
1 小时31 天186 天一般延迟 3-4 小时
1 天366 天366 天一般延迟 4 小时,最长不超过 24 小时

流控信息

请求速率为10/1(s)。

授权信息

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

具体说明如下:展开详情

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

请求参数

字段名称字段详情
DomainNamestring

需要查询的加速域名。支持批量查询,一次最多可以查询 100 个域名,多个域名用英文逗号(,)分隔。展开详情

示例值:example.com参考取值来源:
    AddDcdnIpaDomain
    BatchAddDcdnDomain
    DescribeDcdnWafDomains
StartTimestring

获取数据的起始时间点,日期格式按照 ISO8601 表示法,并使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ。展开详情

示例值:2015-12-10T20:00:00Z
EndTimestring

获取数据的结束时间点,日期格式按照 ISO8601 表示法,并使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ展开详情

示例值:2015-12-10T22:00:00Z
Fieldstring

请求的数据类型。取值:展开详情

示例值:bps
Typestring

请求数类型,取值:展开详情

示例值:dynamic
DataProtocolstring

需要获取的数据的协议。取值:展开详情

示例值:all
Areastring

区域代号。取值:展开详情

示例值:CN
Intervalstring

强制指定获取指定时间粒度的数据,单位为秒。展开详情

示例值:300

请求说明

参数组合说明

计费数据和参数取值的对应关系如下表,具体调用方法请参见请求示例。

计费数据DataProtocol 参数取值Type 参数取值Field 参数取值Area 参数取值
流量all 或不传all 或不传trafCN
OverSeas
AP1
AP2
AP3
NA
SA
EU
MEAA
带宽all 或不传all 或不传bpsCN
OverSeas
AP1
AP2
AP3
NA
SA
EU
MEAA
静态 HTTPS 请求数httpsstaticaccall
动态 HTTP 请求数httpdynamicaccall
动态 HTTPS 请求数httpsdynamicaccall

返回参数

字段名称字段详情
DomainNamestring

查询到的加速域名。

示例值:example.com
EndTimestring

查询数据的结束时间。

示例值:2015-12-10T22:00:00Z
StartTimestring

查询数据的开始时间。

示例值:2015-12-10T20:00:00Z
Typestring

返回的用量类型。

示例值:bps
Areastring

返回的用量区域。

示例值:CN
RequestIdstring

请求 ID。

示例值:B955107D-E658-4E77-B913-E0AC3D31693E
DataIntervalstring

每条记录的时间间隔,单位为秒。

示例值:/
UsageDataPerIntervalobject

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidParameter
The specified parameter is invalid.诊断
400
InvalidStartTime.Malformed
The specified StartTime parameter is invalid.诊断
400
InvalidEndTime.Malformed
The specified EndTime is invalid.诊断
400
InvalidTime.Malformed
Specified StartTime or EndTime is malformed.诊断
400
InvalidParameterField
The specified Field is invalid.诊断
400
InvalidParameterType
The specified Type is invalid.诊断
400
InvalidEndTime.Mismatch
The specified EndTime is earlier than the StartTime.诊断
400
InvalidTimeSpan
The time span exceeds the limit.诊断
400
InvalidParameterInterval
The specified Interval is invalid.诊断

变更历史

变更时间变更内容概要操作
2022-12-26
变更错误码400