DescribePdnsRequestStatistics - 查询公共DNS请求量统计数据列表

查询指定子域名请求量的统计数据。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

pubdns:DescribePdnsRequestStatistics

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	设置请求和接收消息的语言类型，默认为 zh。取值： zh：中文 en：英文	zh
DomainName	string	否	需要查询的主域名名称。	example.com
SubDomain	string	否	要查看统计数据的子域名名称。	www.example.com
Type	string	否	查询请求量统计类型： DOMAIN：按照域名维度查看请求量统计； SUB_DOMAIN：按照子域名维度查看请求量统计；	DOMAIN
StartDate	string	否	查询的开始时间，格式：YYYY-MM-DD。只能查询最近 90 天的记录。	2024-06-14
EndDate	string	否	查询的结束时间，格式：YYYY-MM-DD。默认为查询当天的时间。	2024-07-14
PageNumber	integer	否	当前页数，起始值为 1，默认为 1。	1
PageSize	integer	否	分页查询时设置的每页行数，最大值 100，默认为 20。	20

返回参数

名称	类型	描述	示例值
	object
TotalCount	integer	获取的总列表数。	49
PageSize	integer	分页查询时设置的每页行数，最大值 100，默认为 20。	10
RequestId	string	唯一请求识别码。	536E9CAD-DB30-4647-AC87-AA5CC38C5382
PageNumber	integer	当前页数，起始值为 1，默认为 1。	1
Data	array<object>	请求量数据列表。
	object	请求量数据列表。
DomainName	string	域名名称。	example.com
SubDomain	string	子域名名称。	www.example.com
V6HttpCount	integer	IPv6 HTTP 请求量。	0
V6HttpsCount	integer	IPv6 HTTPS 请求量。	0
TotalCount	integer	请求总量	500
V4HttpCount	integer	IPv4 HTTP 请求量。	0
V4HttpsCount	integer	IPv4 HTTPS 请求量。	0
V4Count	integer	IPv4 请求量。	0
V6Count	integer	IPv6 请求量。	0
HttpCount	integer	HTTP 请求量。	0
HttpsCount	integer	HTTPS 请求量。但在公共 DNS 控制台流量分析页签中，此参数版包含了 DoH 的请求量，所以 DoH 的请求量没有在控制台单独展示。	0
DohTotalCount	integer	Doh 总请求量。Doh 总请求量，包含了 HTTP 和 HTTPS 请求总量。	0
UdpTotalCount	integer	Udp 总请求量。	500
IpCount	integer	源 IP 地址数量。	10
ThreatCount	integer	当前版本暂不支持此参数。	-
MaxThreatLevel	string	当前版本暂不支持此参数。	-
ThreatInfo	array<object>	当前版本暂不支持此参数。
	object	当前版本暂不支持此参数。
ThreatType	string	当前版本暂不支持此参数。	-
ThreatLevel	string	当前版本暂不支持此参数。	-

示例

正常返回示例

JSON格式

{
  "TotalCount": 49,
  "PageSize": 10,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "PageNumber": 1,
  "Data": [
    {
      "DomainName": "example.com",
      "SubDomain": "www.example.com",
      "V6HttpCount": 0,
      "V6HttpsCount": 0,
      "TotalCount": 500,
      "V4HttpCount": 0,
      "V4HttpsCount": 0,
      "V4Count": 0,
      "V6Count": 0,
      "HttpCount": 0,
      "HttpsCount": 0,
      "DohTotalCount": 0,
      "UdpTotalCount": 500,
      "IpCount": 10,
      "ThreatCount": 0,
      "MaxThreatLevel": "-",
      "ThreatInfo": [
        {
          "ThreatType": "-",
          "ThreatLevel": "-"
        }
      ]
    }
  ]
}

错误码

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

变更历史

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