调用DescribeDomainsUsageByDay获取加速域名天粒度监控统计数据,支持获取最近90天的数据。
- 如果您不指定StartTime和EndTime时,默认读取过去24小时的数据;指定StartTime和EndTime时,按指定的起止时间查询。
- 您只能查询一个域名或当前用户下所有域名的数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeDomainsUsageByDay |
操作接口名,系统规定参数。取值:DescribeDomainsUsageByDay。 |
DomainName | String | 否 | www.yourdomain.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 | test.com |
加速域名信息。 |
DataInterval | String | 86400 |
每条记录的时间间隔,单位为秒。 |
StartTime | String | 2019-12-22T08:00:00Z |
开始时间。 |
EndTime | String | 2019-12-23T09:00:00Z |
结束时间。 |
UsageByDays | Array |
每个时间间隔统计数据。 |
|
UsageByDay | |||
BytesHitRate | String | 97.46250599529726 |
命中率。 |
TimeStamp | String | 2019-12-22 |
时间片起始时刻。 |
Qps | String | 7.466354166666667 |
每秒访问量。 |
RequestHitRate | String | 70.24770071912111 |
请求命中率。 |
MaxBps | String | 306747.76 |
带宽峰值。 |
MaxBpsTime | String | 2019-12-23 10:55:00 |
带宽峰值时刻。 |
MaxSrcBps | String | 72584.072 |
回源带宽峰值。 |
TotalAccess | String | 645093 |
总访问量。 |
MaxSrcBpsTime | String | 2019-12-23 11:45:00 |
回源带宽峰值时刻。 |
TotalTraffic | String | 564300099309 |
总流量。 |
UsageTotal | Struct |
汇总数据。 |
|
BytesHitRate | String | 97.03110726801242 |
命中率。 |
RequestHitRate | String | 69.92610837438424 |
请求命中率。 |
MaxBps | String | 1.0747912780000001E8 |
带宽峰值。 |
MaxBpsTime | String | 2019-12-23 10:55:00 |
带宽峰值时刻。 |
MaxSrcBps | String | 72584.072 |
回源带宽峰值。 |
TotalAccess | String | 1319500 |
总访问量。 |
MaxSrcBpsTime | String | 2019-12-23 11:45:00 |
回源带宽峰值时刻。 |
TotalTraffic | String | 1117711832100 |
总流量。 |
示例
请求示例
http://cdn.aliyuncs.com/?Action=DescribeDomainsUsageByDay
&DomainName=test.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>test.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":"test.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. | 域名不存在或不属于当前用户。请检查您填写的域名书写是否正确,或者域名是否在当前账号中,查看域名是否过期。 |
访问错误中心查看更多错误码。