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

说明
  • 如果您不指定StartTime和EndTime时，默认读取过去24小时的数据；指定StartTime和EndTime时，按指定的起止时间查询。
  • 您只能查询单个域名或当前用户下所有域名的数据。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 否 DescribeDomainsUsageByDay

系统规定参数。取值：DescribeDomainsUsageByDay。

DomainName String 否 example.com

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

默认查询当前用户下所有域名。
StartTime String 否 2019-12-22T08:00:00Z

获取数据起始时间点。日期格式按照ISO8601表示法，并使用UTC时间，格式为yyyy-MM-ddTHH:mm:ssZ。
EndTime String 否 2019-12-23T09:00:00Z

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

说明 结束时间需大于起始时间。

返回数据

名称 类型 示例值 描述
RequestId String C88EF8ED-72F0-45EA-9E86-95114E224FC5

请求ID。
DomainName String example.com

加速域名信息。
DataInterval String 86400

每条记录的时间间隔，单位：秒。
StartTime String 2019-12-22T08:00:00Z

开始时间。
EndTime String 2019-12-23T09:00:00Z

结束时间。
UsageByDays Array of UsageByDay

每个时间间隔统计数据。
UsageByDay
BytesHitRate String 97.46250599529726

字节命中率（百分比数据）。
TimeStamp String 2019-12-22

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

每秒访问量（次/秒）。
RequestHitRate String 70.24770071912111

请求命中率（百分比数据）。
MaxBps String 306747.76

带宽峰值，单位：bps。
MaxBpsTime String 2019-12-23 10:55:00

带宽峰值时刻。
MaxSrcBps String 72584.072

回源带宽峰值，单位：bps。
TotalAccess String 645093

总访问量。
MaxSrcBpsTime String 2019-12-23 11:45:00

回源带宽峰值时刻。
TotalTraffic String 564300099309

总流量，单位：Byte。
UsageTotal Struct

汇总数据。
BytesHitRate String 97.03110726801242

字节命中率（百分比数据）。
RequestHitRate String 69.92610837438424

请求命中率（百分比数据）。
MaxBps String 1.0747912780000001E8

带宽峰值，单位：bps。
MaxBpsTime String 2019-12-23 10:55:00

带宽峰值时刻。
MaxSrcBps String 72584.072

回源带宽峰值，单位：bps。
TotalAccess String 1319500

总访问量。
MaxSrcBpsTime String 2019-12-23 11:45:00

回源带宽峰值时刻。
TotalTraffic String 1117711832100

总流量，单位：Byte。

示例

请求示例

http://cdn.aliyuncs.com/?Action=DescribeDomainsUsageByDay
&DomainName=example.com
&StartTime=2019-12-22T08:00:00Z
&EndTime=2019-12-23T09:00:00Z
&<公共请求参数>

正常返回示例

XML格式 

<DescribeDomainsUsageByDayResponse>
  <UsageTotal>
        <RequestHitRate>0.46869615163699024</RequestHitRate>
        <MaxSrcBpsTime>2019-12-23 11:45:00</MaxSrcBpsTime>
        <MaxSrcBps>72584.072</MaxSrcBps>
        <MaxBps>306747.76</MaxBps>
        <TotalTraffic>220090843</TotalTraffic>
        <TotalAccess>1741</TotalAccess>
        <MaxBpsTime>2019-12-23 10:55:00</MaxBpsTime>
        <BytesHitRate>0.9338625414779297</BytesHitRate>
  </UsageTotal>
  <UsageByDays>
        <UsageByDay>
              <TimeStamp>2019-12-23</TimeStamp>
              <RequestHitRate>0.46869615163699024</RequestHitRate>
              <MaxSrcBpsTime>2019-12-23 11:45:00</MaxSrcBpsTime>
              <MaxSrcBps>72584.072</MaxSrcBps>
              <MaxBps>306747.76</MaxBps>
              <TotalTraffic>220090843</TotalTraffic>
              <TotalAccess>1741</TotalAccess>
              <MaxBpsTime>2019-12-23 10:55:00</MaxBpsTime>
              <Qps>0.020150462962962964</Qps>
              <BytesHitRate>0.9338625398107486</BytesHitRate>
        </UsageByDay>
  </UsageByDays>
  <RequestId>0DE5531F-A7C2-4788-A35A-38883193B2D8</RequestId>
  <EndTime>2019-12-23T09:00:00Z</EndTime>
  <StartTime>2019-12-22T08:00:00Z</StartTime>
  <DomainName>example.com</DomainName>
  <DataInterval>86400</DataInterval>
</DescribeDomainsUsageByDayResponse>

JSON格式 

{
	"UsageTotal": {
		"RequestHitRate": "0.46869615163699024",
		"MaxSrcBpsTime": "2019-12-23 11:45:00",
		"MaxSrcBps": 72584.072,
		"MaxBps": 306747.76,
		"TotalTraffic": 220090843,
		"TotalAccess": 1741,
		"MaxBpsTime": "2019-12-23 10:55:00",
		"BytesHitRate": "0.9338625414779297"
	},
	"UsageByDays": {
		"UsageByDay": [
			{
				"TimeStamp": "2019-12-23",
				"RequestHitRate": "0.46869615163699024",
				"MaxSrcBpsTime": "2019-12-23 11:45:00",
				"MaxSrcBps": 72584.072,
				"MaxBps": 306747.76,
				"TotalTraffic": 220090843,
				"TotalAccess": 1741,
				"MaxBpsTime": "2019-12-23 10:55:00",
				"Qps": "0.020150462962962964",
				"BytesHitRate": "0.9338625398107486"
			}
		]
	},
	"RequestId": "0DE5531F-A7C2-4788-A35A-38883193B2D8",
	"EndTime": "2019-12-23T09:00:00Z",
	"StartTime": "2019-12-22T08:00:00Z",
    "DomainName":"example.com",
    "DataInterval":86400
}

错误码

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

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