# 查询域名是否可用
#### 功能介绍
在华为云查询域名可否注册。
#### URI
POST /v2/domains/actions/check-domain-availability
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述          |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户IAM-Token |
   
表2请求Body参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                           |
|:---|:---|:---|:---|
| domain_name | 是    | String | 域名名称，只允许输入1个域名，且包括前缀和后缀。 取值范围：4\~253个字符。 |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数           | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| availability | String | 域名是否可注册。 取值范围： - 0：不可注册  - 1：可以注册  - -1：异常  - -2：高价词  - -3：敏感词   |
   
#### 请求示例
在华为云查询域名可否注册
```
POST https://{endpoint}/v2/domains/actions/check-domain-availability
{
  "domain_name": "yuming20211230.cn"
}
```
#### 响应示例
```
{
  "availability": "1"
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-domain/domain_api_50001.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-domain/domain_api_50002.html)。