调用DescribeRecordStatisticsSummary查询指定域名下的全部子域名的请求量统计。

调试

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

请求参数

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

系统规定参数。取值:DescribeRecordStatisticsSummary

DomainName String dns-example.com

域名名称。

PageNumber Long 1

当前页数,起始值为1,默认为1

StartDate String 2019-07-04

查询的开始时间,格式:YYYY-MM-DD

只能查询最近90天的记录,即:StartDate >= Now - 90。

Lang String en

语言。

PageSize Long 20

分页查询时设置的每页行数,最大值100,最小值为1,默认值为20

EndDate String 2019-07-04

查询的结束时间。格式:YYYY-MM-DD

默认为查询当天的时间。

SearchMode String EXACT

关键词的搜索模式。取值:

  • 模糊搜索(默认):LIKE
  • 精确搜索:EXACT
Keyword String test

关键词,按照“%KeyWord%”模式搜索,不区分大小写。

Threshold Long 12

查询总量阈值,也可查询相应的请求量不大于threshold的数据。例如,可查询出请求量小于100次的域名。

返回数据

名称 类型 示例值 描述
RequestId String E49F0023-4A98-486F-8BA3-6003D5664105

请求ID。

TotalItems Integer 3

数据总个数。

TotalPages Integer 1

数据分页后总页数。

PageSize Integer 20

每页数据条数。

PageNumber Integer 1

当前页码。

Statistics Array

请求量数据列表。

SubDomain String t1.alitest2.com

子域名。

Count Long 838711553

请求量(次)。

示例

请求示例

http(s)://alidns.aliyuncs.com/?Action=DescribeRecordStatisticsSummary
&DomainName=dns-example.com
&PageNumber=1
&StartDate=2019-07-04
&<公共请求参数>

正常返回示例

XML 格式

<DescribeRecordStatisticsSummaryResponse>
    <PageNumber>1</PageNumber>
    <Statistics>
        <Statistic>
            <Count>838711553</Count>
            <SubDomain>t1.alitest2.com</SubDomain>
        </Statistic>
        <Statistic>
            <Count>3467</Count>
            <SubDomain>alitest2.com</SubDomain>
        </Statistic>
        <Statistic>
            <Count>487</Count>
            <SubDomain>txt.alitest2.com</SubDomain>
        </Statistic>
    </Statistics>
    <PageSize>20</PageSize>
    <RequestId>E49F0023-4A98-486F-8BA3-6003D5664105</RequestId>
    <TotalItems>3</TotalItems>
    <TotalPages>1</TotalPages>
</DescribeRecordStatisticsSummaryResponse>

JSON 格式

{
  "PageNumber": 1,
  "Statistics": {
    "Statistic": [
      {
        "Count": 838711553,
        "SubDomain": "t1.alitest2.com"
      },
      {
        "Count": 3467,
        "SubDomain": "alitest2.com"
      },
      {
        "Count": 487,
        "SubDomain": "txt.alitest2.com"
      }
    ]
  },
  "PageSize": 20,
  "RequestId": "E49F0023-4A98-486F-8BA3-6003D5664105",
  "TotalItems": 3,
  "TotalPages": 1
}

错误码

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