全部产品
Search

搜索本产品

    云解析 DNS：DescribeDomainResolveStatisticsSummary - 获取域名的请求量统计列表

    文档中心

    云解析 DNS：DescribeDomainResolveStatisticsSummary - 获取域名的请求量统计列表

    更新时间：Oct 24, 2024

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

    调试

    您可以在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 错误码发生变更查看变更详情