
# 查询域名详情
#### 功能介绍
在华为云查询当前帐号下域名的详细信息。
#### URI
GET /v2/domain-info
表1Query参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                           |
|:---|:---|:---|:---|
| domain_name | 是    | String | 域名名称，只允许输入1个域名，且包括前缀和后缀。 取值范围：4\~253个字符。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述          |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户IAM-Token |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数                        | 参数类型                                                          | 描述                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| domain_name               | String                                                        | 域名名称                                                                                                                                                                                                                                                                                     |
| expire_date               | String                                                        | 域名到期时间，eg：2023-01-10                                                                                                                                                                                                                                                                     |
| status                    | String                                                        | 域名服务状态                                                                                                                                                                                                                                                                                   |
| audit_status              | String                                                        | 实名审核状态                                                                                                                                                                                                                                                                                   |
| audit_unpass_reason       | String                                                        | 实名审核不通过原因                                                                                                                                                                                                                                                                                |
| transfer_status           | String                                                        | 过户状态                                                                                                                                                                                                                                                                                     |
| reg_type                  | String                                                        | 注册类型                                                                                                                                                                                                                                                                                     |
| privacy_protection        | String                                                        | 是否开启隐私保护                                                                                                                                                                                                                                                                                 |
| name_server               | Array of String                                               | 域名服务器列表                                                                                                                                                                                                                                                                                  |
| contact                   | Array of [表4] objects | 联系人信息                                                                                                                                                                                                                                                                                    |
| order_id                  | String                                                        | 订单ID                                                                                                                                                                                                                                                                                     |
| template_id               | String                                                        | 当前关联的模板ID                                                                                                                                                                                                                                                                                |
| transfer_template_id      | String                                                        | 过户的目标模板ID                                                                                                                                                                                                                                                                                |
| transfer_support_template | Boolean                                                       | 是否支持模板绑定                                                                                                                                                                                                                                                                                 |
| outState                  | String                                                        | 域名转出状态 - OUTING：转出中                                                                                                                           |
| auto_renew_inner          | String                                                        | 自动续费。 取值范围： - 0：手工续费  - 1：自动续费   |
| credential_type           | String                                                        | 证件类型                                                                                                                                                                                                                                                                                     |
| credential_id             | String                                                        | 证件号码                                                                                                                                                                                                                                                                                     |
| registrar                 | String                                                        | 域名所属注册商                                                                                                                                                                                                                                                                                  |
   
 表4Contact 
| 参数              | 参数类型   | 描述        |
|:---|:---|:---|
| email           | String | 邮箱地址      |
| register_cn     | String | 域名所有者（中文） |
| register_en     | String | 域名所有者（英文） |
| contact_name_cn | String | 联系人（中文）   |
| contact_name_en | String | 联系人（英文）   |
| phone_num       | String | 联系电话      |
| province_cn     | String | 省份中文名     |
| province_en     | String | 省份英文名     |
| city_cn         | String | 城市中文名     |
| city_en         | String | 城市英文名     |
| address_cn      | String | 通讯地址（中文）  |
| address_en      | String | 通讯地址（英文）  |
| zip_code        | String | 邮编        |
   
#### 请求示例
在华为云查询当前帐号下域名的详细信息
```
GET https://{endpoint}/v2/domain-info?domain_name=1650327889429.top
```
#### 响应示例
```
{
    "domain_name":"xxx.top",
    "expire_date":"2024-04-19",
    "status":"serverHold",
    "audit_status":"AUDITING",
    "audit_unpass_reason":null,
    "transfer_status":null,
    "reg_type":"PERSON",
    "privacy_protection":false,
    "name_server":[
        "ns11.xincache.com",
        "ns12.xincache.com"
    ],
    "contact":{
        "email":"xx",
        "register_cn":"xx",
        "register_en":"xx",
        "contact_name_cn":"xx",
        "contact_name_en":"xx",
        "phone_num":"xx",
        "province_cn":"xx",
        "province_en":"xx",
        "city_cn":"xx",
        "city_en":"xx",
        "address_cn":"xx",
        "address_en":"xx",
        "zip_code":"xx"
    },
    "order_id":"dajtyxxx",
    "template_id":"8abf6fb67fd55e18017fdxxxxxxx",
    "transfer_template_id":null,
    "transfer_support_template":true,
    "outState":null,
    "auto_renew_inner":null,
    "credential_type":null,
    "credential_id":null,
    "registrar":"XIN_NET"
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-domain/domain_api_50001.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-domain/domain_api_50002.html)。
