调用DescribeDomainResolveStatisticsSummary获取域名请求量统计列表-云解析DNS-阿里云

查询用户账号下所有付费域名的请求量列表。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

alidns:DescribeDomainResolveStatisticsSummary

list

*全部资源

*

无

请求参数

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

返回参数

名称	类型	描述	示例值
	object	PopResultDTO<PageResult>
RequestId	string	唯一请求识别码。	6856BCF6-11D6-4D7E-AC53-FD579933522B
PageSize	integer	分页查询时设置的每页行数，最大值 100，默认为 20。	20
PageNumber	integer	当前页数，起始值为 1，默认为 1。	1
TotalPages	integer	数据分页后总页数。	1
TotalItems	integer	总数据条数。	1
Statistics	array<object>	统计数据列表。
	object
DomainName	string	域名名称。	example.com
Count	string	请求量（次）。	35509014
DomainType	string	域名类型。 PUBLIC：权威托管域名 CACHE：权威代理域名	CACHE

示例

正常返回示例

JSON格式

{
  "RequestId": "6856BCF6-11D6-4D7E-AC53-FD579933522B",
  "PageSize": 20,
  "PageNumber": 1,
  "TotalPages": 1,
  "TotalItems": 1,
  "Statistics": [
    {
      "DomainName": "example.com",
      "Count": "35509014",
      "DomainType": "CACHE"
    }
  ]
}

错误码

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.

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

变更历史

更多信息，参考变更详情。