DescribeDomainResolveStatisticsSummary - 获取域名的请求量统计列表

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

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
Keywordstring

关键字,与 SearchMode 配合使用。

test
SearchModestring

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

  • 模糊搜索(默认):LIKE

  • 精确搜索:EXACT

EXACT
Directionstring

排序方向。取值:

  • 递减:DESC

  • 递增:ASC

DESC
Thresholdlong

解析量查询条件,可用于查询不同解析量类别的域名列表及域名解析量数据。

不传:查询解析量不为 0 的数据

传小于 0 的值:查询所有数据

传 0:查询无解析量的数据

传大于 0 的值:查询解析量不超过该值的域名

-1
StartDatestring

开始时间,格式 yyyy-MM-dd,如: 2023-03-01

2023-03-01
EndDatestring

结束时间,格式 yyyy-MM-dd,如:2023-03-13

2023-03-01
PageNumberinteger

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

1
PageSizeinteger

分页查询时设置的每页行数,最大值 1000,最小值为 1。

10
Langstring

lang,语言:zh、en、ja。

zh

返回参数

名称类型描述示例值
object

PopResultDTO<PageResult>

RequestIdstring

唯一请求识别码。

6856BCF6-11D6-4D7E-AC53-FD579933522B
PageSizeinteger

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

20
PageNumberinteger

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

1
TotalPagesinteger

数据分页后总页数。

1
TotalItemsinteger

总数据条数。

1
Statisticsarray<object>

统计数据列表。

Statisticobject
DomainNamestring

域名名称。

example.com
Countstring

请求量(次)。

35509014
DomainTypestring

域名类型。

  • 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错误码错误信息
400Statistics.TooManyResultsYour query has produced too many results.
400Statistics.InvalidDomainNameYour query param DomainName is invalid.
400Statistics.InvalidStartDateYour query param StartDate is invalid.
400Statistics.InvalidEndDateYour query param EndDate is invalid.
400Statistics.InvalidSearchModeYour query param SearchMode is invalid.
400Statistics.InvalidOrderDirectionYour query param OrderDirection is invalid.
400Statistics.InvalidDomainTypeYour query param DomainType is invalid.
400Statistics.QuotaExceededTimeYour query time range exceeds 90 days.
400Sys.ParamsErrorYour query param is invalid.

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

变更历史

变更时间变更内容概要操作
2024-01-29OpenAPI 错误码发生变更查看变更详情