全部产品
Search
文档中心

CDN:DescribeDomainsUsageByDay - 查询用量-按天

更新时间:May 30, 2023

调用DescribeDomainsUsageByDay查询加速域名天粒度的监控统计数据,支持获取最近90天的数据。

接口说明

  • 单用户调用频率:10次/秒。
  • 如果您不指定StartTime和EndTime时,默认读取过去24小时的数据;指定StartTime和EndTime时,按指定的起止时间查询。
  • 您只能查询单个域名或当前用户下所有域名的数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
cdn:DescribeDomainsUsageByDayREAD
  • CDN
    acs:cdn:*:{#accountId}:domain/{#DomainName}

请求参数

名称类型必填描述示例值
DomainNamestring

加速域名,只支持填写一个域名。

默认查询当前用户下所有域名。

example.com
StartTimestring

获取数据起始时间点。

日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

2019-12-22T08:00:00Z
EndTimestring

获取数据结束时间点。

日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

说明结束时间需大于起始时间。
2019-12-23T09:00:00Z

返回参数

名称类型描述示例值
object
EndTimestring

结束时间。

2019-12-23T09:00:00Z
StartTimestring

开始时间。

2019-12-22T08:00:00Z
RequestIdstring

请求ID。

C88EF8ED-72F0-45EA-9E86-95114E224FC5
DomainNamestring

加速域名信息。

example.com
DataIntervalstring

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

86400
UsageTotalobject

汇总数据。

MaxSrcBpsTimestring

回源带宽峰值时刻。

2019-12-23 11:45:00
RequestHitRatestring

请求命中率(百分比数据)。

69.92610837438424
MaxBpsstring

带宽峰值,单位:bps。

1.0747912780000001E8
TotalAccessstring

总访问量。

1319500
BytesHitRatestring

字节命中率(百分比数据)。

97.03110726801242
TotalTrafficstring

总流量,单位:Byte。

1117711832100
MaxBpsTimestring

带宽峰值时刻。

2019-12-23 10:55:00
MaxSrcBpsstring

回源带宽峰值,单位:bps。

72584.072
UsageByDaysobject []

每个时间间隔统计数据。

MaxSrcBpsTimestring

回源带宽峰值时刻。

2019-12-23 11:45:00
Qpsstring

每秒访问量(次/秒)。

7.466354166666667
RequestHitRatestring

请求命中率(百分比数据)。

70.24770071912111
MaxBpsstring

带宽峰值,单位:bps。

306747.76
TotalAccessstring

总访问量。

645093
TimeStampstring

查询数据的时间片起始时刻。

2019-12-22
BytesHitRatestring

字节命中率(百分比数据)。

97.46250599529726
TotalTrafficstring

总流量,单位:Byte。

564300099309
MaxSrcBpsstring

回源带宽峰值,单位:bps。

72584.072
MaxBpsTimestring

带宽峰值时刻。

2019-12-23 10:55:00

示例

正常返回示例

JSON格式

{
  "EndTime": "2019-12-23T09:00:00Z",
  "StartTime": "2019-12-22T08:00:00Z",
  "RequestId": "C88EF8ED-72F0-45EA-9E86-95114E224FC5",
  "DomainName": "example.com",
  "DataInterval": "86400",
  "UsageTotal": {
    "MaxSrcBpsTime": "2019-12-23 11:45:00",
    "RequestHitRate": "69.92610837438424",
    "MaxBps": "1.0747912780000001E8",
    "TotalAccess": "1319500",
    "BytesHitRate": "97.03110726801242",
    "TotalTraffic": "1117711832100",
    "MaxBpsTime": "2019-12-23 10:55:00",
    "MaxSrcBps": "72584.072"
  },
  "UsageByDays": {
    "UsageByDay": [
      {
        "MaxSrcBpsTime": "2019-12-23 11:45:00",
        "Qps": "7.466354166666667",
        "RequestHitRate": "70.24770071912111",
        "MaxBps": "306747.76",
        "TotalAccess": "645093",
        "TimeStamp": "2019-12-22",
        "BytesHitRate": "97.46250599529726",
        "TotalTraffic": "564300099309",
        "MaxSrcBps": "72584.072",
        "MaxBpsTime": "2019-12-23 10:55:00"
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidStartTime.MalformedSpecified StartTime is malformed.起始时间格式错误。日期格式请参考所调用API的帮助文档说明。
400InvalidEndTime.MalformedSpecified EndTime is malformed.结束时间格式错误。请核对后重新提供。
400InvalidStartTime.ValueNotSupportedThe specified value of parameter StartTime is not supported.开始时间设置错误,请检查更新后重试。
400InvalidEndTime.MismatchSpecified EndTime does not math the specified StartTime.-
404InvalidDomain.NotFoundThe domain provided does not exist in our records.域名不存在或不属于当前用户。请检查您填写的域名书写是否正确,或者域名是否在当前账号中,查看域名是否过期。

访问错误中心查看更多错误码。