获取加速域名的字节命中率(命中字节百分比)。

  • 不指定StartTime和EndTime时,默认读取过去24小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。
  • 支持批量域名查询,多个域名可用逗号(半角)分隔。
  • 最多可获取最近90天的数据。

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribeDomainHitRateData 系统规定参数。取值:DescribeDomainHitRateData
DomainName String www.yourdomain.com 需要查询的加速域名,只支持一个域名,不写代表所有。
EndTime String 2017-12-22T08:00:00:00Z
  • 结束时间需大于起始时间。
  • 获日期格式按照ISO8601表示法,并使用UTC时间。
  • 格式为:YYYY-MM-DDThh:mmZ。
Interval String 300
  • 查询数据的时间粒度。
  • 支持300, 3600, 14400, 28800和86400秒。
  • 不传和传的值不支持时,使用默认值300秒。
IspNameEn String unicom 运营商英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有运营商。
LocationNameEn String beijing 区域英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有区域。
StartTime String 2017-12-21T08:00:00:00Z
  • 获取数据起始时间点。
  • 日期格式按照ISO8601表示法,并使用UTC时间。
  • 格式为:YYYY-MM-DDThh:mmZ。
  • 最小数据粒度为5分钟。
  • 不写默认读取过去24小时数据。
TimeMerge String on

取值范围:

  • on:默认值,每条记录的时间间隔会根据时间跨度做合并。
  • off:返回5分钟粒度数据,最大时间跨度为31天。

返回参数

参数 类型 示例值 描述
DomainName String test.com 加速域名信息。
DataInterval String 300 每条记录的时间间隔,以秒为单位。
StartTime String 2015-12-10T20:00Z 开始时间。
EndTime String 2015-12-10T21:00Z 结束时间。
HitRateInterval 每个时间间隔的字节命中百分占比。
  └TimeStamp String 2017-12-22T08:00:00:00Z 时间片起始时刻。
  └Value String 100.0 详细使用数据。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 请求ID。

示例

请求示例


http://cdn.aliyuncs.com?Action=DescribeDomainHitRateData&DomainName=test.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&公共请求参数
正常返回示例
  • JSON格式

    {
        "DataInterval":"300",
        "DomainName":"test.com",
        "EndTime":"2015-12-10T21:00Z",
        "HitRateInterval":{
            "DataModule":[
                {
                    "TimeStamp":"2015-12-10T21:00:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:35:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:50:00Z",
                    "Value":"99.99932881437826"
                },
                {
                    "TimeStamp":"2015-12-10T20:05:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:10:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:55:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:30:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:25:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:00:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:40:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:15:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:45:00Z",
                    "Value":"100.0"
                },
                {
                    "TimeStamp":"2015-12-10T20:20:00Z",
                    "Value":"100.0"
                }
            ]
        },
        "RequestId":"5ADA5190-EE5B-4EF2-BE00-DC441B8D81DD",
        "StartTime":"2015-12-10T20:00Z"
    }
异常返回示例
  • JSON格式

    {
        "Code":"InternalError",
        "HostId":"cdn.aliyuncs.com",
        "Message":"The request processing has failed due to some unknown error.",
        "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    }