调用DescribeRecordResolveStatisticsSummary获取子域名的请求量统计

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

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
alidns:DescribeRecordResolveStatisticsSummary		Domain acs:alidns:*:{#accountId}:domain/{#DomainName}	无	无

请求参数

名称	类型	必填	描述	示例值
DomainName	string	是	域名名称。	example.com
DomainType	string	否	域名类型，大小写不敏感。取值： PUBLIC：权威托管域名（默认值） CACHE：权威代理域名	PUBLIC
Keyword	string	否	关键字，与 SearchMode 配合使用。	test
SearchMode	string	否	关键词的搜索模式。取值：模糊搜索（默认）：LIKE 精确搜索：EXACT	LIKE
Direction	string	否	排序方向。取值：递减（默认）：DESC 递增：ASC	DESC
Threshold	long	否	解析量查询条件，可用于查询不同解析量类别的子域名列表及子域名解析量数据。不传：查询解析量非 0 的数据传小于 0 的值：查询所有数据传 0：查询无解析量的数据传大于 0 的值：查询解析量不超过该值的子域名	-1
StartDate	string	是	开始时间，格式 yyyy-MM-dd，如: 2023-03-01。	2023-03-29
EndDate	string	否	结束时间，格式 yyyy-MM-dd，如：2023-03-13。	2023-03-29
PageNumber	integer	否	当前页数，起始值为 1，默认为 1。	1
PageSize	integer	否	分页查询时设置的每页行数，最大值 1000，最小值为 1。	10
Lang	string	否	lang，语言：zh、en、ja。	zh

返回参数

名称	类型	描述	示例值
	object	PopResultDTO<PageResult>
RequestId	string	唯一请求识别码。	389DFFA3-77A5-4A9E-BF3D-147C6F98A5BA
PageSize	integer	分页查询时设置的每页行数，最大值 500，默认为 20。	10
PageNumber	integer	当前页数，起始值为 1，默认为 1。	1
TotalPages	integer	数据分页后总页数。	1
TotalItems	integer	总数据条数。	1
Statistics	array<object>	统计数据列表。
Statistic	object
SubDomain	string	子域。	test.example.com
DomainName	string	子域名。	test.example.com
Count	string	请求量（次）。	330
DomainType	string	域名类型，大小写不敏感。取值： PUBLIC：权威托管域名（默认值） CACHE：权威代理域名	PUBLIC

示例

正常返回示例

JSON格式

{
  "RequestId": "389DFFA3-77A5-4A9E-BF3D-147C6F98A5BA",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalPages": 1,
  "TotalItems": 1,
  "Statistics": [
    {
      "SubDomain": "test.example.com",
      "DomainName": "test.example.com",
      "Count": "330",
      "DomainType": "PUBLIC"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息
400	Statistics.TooManyResults	Your query has produced too many results.
400	Statistics.InvalidDomainName	Your query param DomainName is invalid.
400	Statistics.InvalidStartDate	Your query param StartDate is invalid.
400	Statistics.InvalidEndDate	Your query param EndDate is invalid.
400	Statistics.InvalidSearchMode	Your query param SearchMode is invalid.
400	Statistics.InvalidOrderDirection	Your query param OrderDirection is invalid.
400	Statistics.InvalidDomainType	Your query param DomainType is invalid.
400	Statistics.QuotaExceededTime	Your query time range exceeds 90 days.
400	Sys.ParamsError	Your query param is invalid.

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

变更历史

变更时间	变更内容概要	操作
2023-11-23	OpenAPI 错误码发生变更	查看变更详情
2023-04-04	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情