# 查询域名统计信息 - ShowDomainsStatusStats
#### 功能介绍
查询域名统计信息。
- 单租户调用频率：5次/s。
  
 
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-cdn/cdn_02_0019.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cdn/cdn_02_0020.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                                       | 访问级别 | 资源类型（\*为必须） | 条件键                   | 别名                             | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | cdn:configuration:queryDomainsStatusStats | Read | -           | g:EnterpriseProjectId | cdn:configuration:queryDomains | -      |
     
  
 
#### URI
GET /v1.0/cdn/domains/statistic
表1Query参数 
| 参数     | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| 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 | 按业务类型分组统计 |
   
 表4domain_status 
| 参数               | 参数类型    | 描述         |
|:---|:---|:---|
| online           | Integer | 已开启的域名个数。  |
| offline          | Integer | 已停用的域名个数。  |
| configuring      | Integer | 配置中的域名个数。  |
| configure_failed | Integer | 配置失败的域名个数。 |
| checking         | Integer | 审核中的域名个数。  |
| check_failed     | Integer | 审核失败的域名个数。 |
| syn_failed       | Integer | 同步失败的域名个数。 |
| deleting         | Integer | 删除中的域名个数。  |
   
 表5business_type 
| 参数         | 参数类型    | 描述             |
|:---|:---|:---|
| download   | Integer | 文件下载加速类型的域名个数。 |
| liveStream | Integer | 直播加速类型的域名个数。   |
| video      | Integer | 点播加速类型的域名个数。   |
| web        | Integer | 网站加速类型的域名个数。   |
| wholeSite  | Integer | 全站加速类型的域名个数。   |
   
**状态码：400**
表6响应Body参数 
| 参数    | 参数类型                                                      | 描述              |
|:---|:---|:---|
| error | [ErrMsg] object | 用于返回具体的错误码和错误消息 |
   
 表7ErrMsg 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| 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 | 请求失败。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。
