文档首页/ 内容分发网络 CDN/ API参考/ API/ 域名操作/ 查询域名统计信息 - ShowDomainsStatusStats
更新时间:2026-11-06 GMT+08:00
分享

查询域名统计信息 - ShowDomainsStatusStats

功能介绍

查询域名统计信息。

  • 单租户调用频率:5次/s。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    cdn:configuration:queryDomainsStatusStats

    Read

    -

    g:EnterpriseProjectId

    cdn:configuration:queryDomains

    -

URI

GET /v1.0/cdn/domains/statistic

表1 Query参数

参数

是否必选

参数类型

描述

factor

是

String

参数解释:

统计资源类型

约束限制:

不涉及

取值范围:

domains: 统计域名信息

默认取值:

不涉及

type

是

String

参数解释:

统计维度,支持按域名状态和业务维度统计

约束限制:

不涉及

取值范围:

  • domain_status: 域名状态

  • business_type: 业务类型

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户鉴权Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

factor

String

查询资源类型。

domain_status

domain_status object

按域名状态分组统计

business_type

business_type object

按业务类型分组统计

表4 domain_status

参数

参数类型

描述

online

Integer

已开启的域名个数。

offline

Integer

已停用的域名个数。

configuring

Integer

配置中的域名个数。

configure_failed

Integer

配置失败的域名个数。

checking

Integer

审核中的域名个数。

check_failed

Integer

审核失败的域名个数。

syn_failed

Integer

同步失败的域名个数。

deleting

Integer

删除中的域名个数。

表5 business_type

参数

参数类型

描述

download

Integer

文件下载加速类型的域名个数。

liveStream

Integer

直播加速类型的域名个数。

video

Integer

点播加速类型的域名个数。

web

Integer

网站加速类型的域名个数。

wholeSite

Integer

全站加速类型的域名个数。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error

ErrMsg object

用于返回具体的错误码和错误消息

表7 ErrMsg

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

  • GET https://cdn.myhuaweicloud.com//v1.0/cdn/domains/statistic?factor=domains&type=domain_status&enterprise_project_id=all
  • GET https://cdn.myhuaweicloud.com//v1.0/cdn/domains/statistic?factor=domains&type=business_type&enterprise_project_id=all

响应示例

状态码:200

  • 按域名状态分组查询结果

    {
      "factor" : "domains",
      "domain_status" : {
        "online" : 10,
        "offline" : 0,
        "configuring" : 1,
        "configure_failed" : 0,
        "checking" : 0,
        "check_failed" : 0,
        "syn_failed" : 0,
        "deleting" : 0
      }
    }
  • 按业务类型分组查询结果

    {
      "factor" : "domains",
      "business_type" : {
        "download" : 10,
        "liveStream" : 0,
        "video" : 1,
        "web" : 0,
        "wholeSite" : 0
      }
    }

状态码

状态码

描述

200

请求成功。

400

请求失败。

错误码

请参见错误码。

相关文档