# 查询域名
#### 功能介绍
在华为云查询当前帐号的域名列表。
#### URI
GET /v2/domains
表1Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                         |
|:---|:---|:---|:---|
| offset | 否    | Integer | 分页偏移量。 取值范围：0\~1000000 |
| limit  | 否    | Integer | 每页数量。 取值范围：1\~200        |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述          |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户IAM-Token |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数      | 参数类型                                                       | 描述   |
|:---|:---|:---|
| domains | Array of [表4] objects | 域名集合 |
| total   | Integer                                                    | 总数量  |
   
 表4Domain 
| 参数                    | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| domain_name           | String  | 域名名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| privacy_protection    | Boolean | 隐私保护。 取值范围： - true  - false                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| register_date         | String  | 域名注册时间，eg：2023-01-10                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| expire_date           | String  | 域名到期时间，eg：2023-01-10                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| status                | String  | 域名状态。 取值范围： - REGISTERING：域名注册中  - REVIEW_FAILED：命名审核失败  - REDEEM：赎回期  - WAITDELETED：删除期  - EXPIRE：已过期  - TRANSFER_AUDITING：过户审核中  - TRANSFER_FAILED：过户失败  - NONAUDIT：未实名认证  - SUCCEED：已实名认证  - FAILED：实名认证失败  - AUDITING：实名认证审核中   |
| reg_type              | String  | 域名注册类型。 取值范围： - PERSONAL：个人  - COMPANY：企业                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| audit_status          | String  | 域名实名认证状态。 取值范围： - NONAUDIT：未实名认证  - SUCCEED：已实名认证  - FAILED：实名认证失败  - AUDITING：实名认证审核中                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| audit_fail_reason     | String  | 域名实名认证失败原因                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| transfer_audit_status | String  | 域名过户实名认证状态。 取值范围： - TRANSFER_AUDITING：过户审核中  - TRANSFER_FAILED：过户失败  - TRANSFER_SUCCEED：过户成功  - null：为空代表没有操作过域名过户                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| order_id              | String  | 订单编号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| out_status            | String  | 转出状态                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| auto_renew            | String  | 自动续费。 取值范围： - 0：手工续费  - 1：自动续费                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
#### 请求示例
在华为云查询当前帐号的域名列表
```
GET https://{endpoint}/v2/domains?limit=1&offset=0
```
#### 响应示例
```
{
  "domains": [
    {
      "domain_name": "202201131503.top",
      "privacy_protection": false,
      "register_date": "2022-01-13",
      "expire_date": "2023-01-13",
      "status": "NONAUDIT",
      "reg_type": "PERSON",
      "audit_status": "NONAUDIT",
      "audit_fail_reason": null,
      "transfer_status": null,
      "order_id": "CS2201131505AN5EI",
      "out_status": null,
      "auto_renew": "0"
    }
  ],
  "total": 1678
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-domain/domain_api_50001.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-domain/domain_api_50002.html)。