调用DescribeDcdnDomainPvData获取加速域名最小1小时粒度的PV页面访问统计。

调试

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

请求参数

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

操作接口名,系统规定参数。取值:DescribeDcdnDomainPvData

DomainName String example.com

加速域名,仅支持查询单个域名。

StartTime String 2019-11-28T00:00:00Z

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

EndTime String 2019-11-29T00:00:00Z

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

返回数据

名称 类型 示例值 描述
RequestId String BCD7D917-76F1-442F-BB75-C810DE34C761

请求ID。

DomainName String example.com

加速域名信息。

DataInterval String 3600

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

StartTime String 2019-11-28T00:00:00Z

开始时间。

EndTime String 2019-11-29T00:00:00Z

结束时间。

PvDataInterval Array

每个时间间隔的页面访问次数。

TimeStamp String 2015-11-28T03:00:00Z

时间片起始时刻。

Value String 9292

详细使用数据。

示例

请求示例

http://dcdn.aliyuncs.com?Action=DescribeDcdnDomainPvData
&DomainName=example.com
&StartTime=2019-11-28T00:00:00Z
&EndTime=2019-11-29T00:00:00Z
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDcdnDomainPvDataResponse>
  <DataInterval>3600</DataInterval>
  <RequestId>BCD7D917-76F1-442F-BB75-C810DE34C761</RequestId>
  <DomainName>example.com</DomainName>
  <EndTime>2019-11-29T00:00:00Z</EndTime>
  <PvDataInterval>
        <UsageData>
              <TimeStamp>2015-11-29T03:00:00Z</TimeStamp>
              <Value>9292</Value>
        </UsageData>
        <UsageData>
              <TimeStamp>2015-11-29T23:00:00Z</TimeStamp>
              <Value>9239</Value>
        </UsageData>
  </PvDataInterval>
  <StartTime>2019-11-28T00:00:00Z</StartTime>
</DescribeDcdnDomainPvDataResponse>

JSON 格式

{
    "DataInterval": "3600",
    "RequestId": "BCD7D917-76F1-442F-BB75-C810DE34C761",
    "DomainName": "example.com",
    "EndTime": "2019-11-29T00:00:00Z",
    "PvDataInterval": {
        "UsageData": [
            {
                "TimeStamp": "2015-11-29T03:00:00Z",
                "Value": "9292"
            },
            {
                "TimeStamp": "2015-11-29T23:00:00Z",
                "Value": "9239"
            }
        ]
    },
    "StartTime": "2019-11-28T00:00:00Z"
}

错误码

HttpCode 错误码 错误信息 描述
400 MissingTimeParameter The StartTime and EndTime must be both specified. 请同时提供开始时间和结束时间。
400 InvalidStartTime.Malformed The specified StartTime is invalid. 请提供正确的开始时间格式。日期格式按照ISO8601表示法,并使用UTC时间。\n格式为:YYYY-MM-DDThh:mm:ssZ
400 InvalidEndTime.Malformed The specified EndTime is invalid. 请提供正确的结束时间格式。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ
400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. 结束时间早于开始时间,请检查。
400 InvalidStartTime.ValueNotSupported The specified StartTime is invalid. 不支持该开始时间,请重新填写。

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