
# 查询加速域名详情
#### 功能介绍
查询加速域名详情。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CDN&api=ShowDomainDetail&version=v1)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v1.0/cdn/domains/{domain_id}/detail
表1路径参数 
| 参数        | 是否必选 | 参数类型   | 描述                    |
|:---|:---|:---|:---|
| domain_id | 是    | String | 加速域名ID。获取方法请参见查询加速域名。 |
   
表2Query参数 
| 参数                    | 是否必选 | 参数类型   | 描述                                                                                                                                                                 |
|:---|:---|:---|:---|
| enterprise_project_id | 否    | String | 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                          |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数     | 参数类型                                                                  | 描述   |
|:---|:---|:---|
| domain | [DomainsWithPort] object | 域名信息 |
   
 表5DomainsWithPort 
| 参数                    | 参数类型                                                                          | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| id                    | String                                                                        | 加速域名ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| domain_name           | String                                                                        | 加速域名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| business_type         | String                                                                        | 域名业务类型，若为web，则表示类型为网站加速；若为download，则表示业务类型为文件下载加速；若为video，则表示业务类型为点播加速；若为wholeSite，则表示类型为全站加速。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| user_domain_id        | String                                                                        | 域名所属用户的domain_id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| domain_status         | String                                                                        | 加速域名状态。取值意义： - online表示"已开启"  - offline表示"已停用"  - configuring表示"配置中"  - configure_failed表示"配置失败"  - checking表示"审核中"  - check_failed表示"审核未通过"  - deleting表示"删除中"。   |
| cname                 | String                                                                        | 加速域名对应的CNAME。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| sources               | Array of [SourceWithPort] objects | 源站域名或源站IP，源站为IP类型时，仅支持IPv4，如需传入多个源站IP，以多个源站对象传入，除IP其他参数请保持一致，主源站最多支持15个源站IP对象，备源站最多支持15个源站IP对象；源站为域名类型时仅支持1个源站对象。不支持IP源站和域名源站混用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| domain_origin_host    | [DomainOriginHost] object       | 域名回源设置信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| https_status          | Integer                                                                       | 是否开启HTTPS加速。 0：代表未开启HTTPS加速； 1：代表开启HTTPS加速，且回源方式为协议跟随； 2：代表开启HTTPS加速，且回源方式为HTTP； 3：代表开启HTTPS加速，且回源方式为HTTPS。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| create_time           | Long                                                                          | 域名创建时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| modify_time           | Long                                                                          | 域名修改时间，相对于UTC 1970-01-01到当前时间相隔的毫秒数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| disabled              | Integer                                                                       | 封禁状态（0代表未禁用；1代表禁用）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| locked                | Integer                                                                       | 锁定状态（0代表未锁定；1代表锁定）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| auto_refresh_preheat  | Integer                                                                       | 自动刷新预热（0代表关闭；1代表打开）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| service_area          | String                                                                        | 华为云CDN提供的加速服务范围，包含：mainland_china中国大陆、outside_mainland_china中国大陆境外、global全球。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| range_status          | String                                                                        | Range回源状态（off代表关闭 on代表开启）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| follow_status         | String                                                                        | 回源跟随状态（off代表关闭 on代表开启）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| origin_status         | String                                                                        | 是否暂停源站回源（off代表关闭 on代表开启）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| banned_reason         | String                                                                        | 域名禁用原因。 1：该域名涉嫌违规内容（涉黄/涉赌/涉毒/涉政）已被禁用； 2：该域名因备案失效已被禁用； 3：该域名遭受攻击，已被禁用； 150：该域名涉嫌违规内容涉黄已被禁用； 151：该域名涉嫌违规内容涉政已被禁用； 152：该域名涉嫌违规内容涉暴已被禁用； 153：该域名涉嫌违规内容涉赌已被禁用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| locked_reason         | String                                                                        | 域名锁定原因（Changing the config, please wait）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| enterprise_project_id | String                                                                        | 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，不传表示查询默认项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
 表6SourceWithPort 
| 参数                     | 参数类型    | 描述                                                                   |
|:---|:---|:---|
| domain_id              | String  | 加速域名id。                                                              |
| ip_or_domain           | String  | 源站IP（非内网IP）或者域名。                                                     |
| origin_type            | String  | 源站类型（"ipaddr"： "IP源站"；"domain"： "域名源站"；"obs_bucket"： "OBS Bucket源站"） |
| active_standby         | Integer | 主备状态（1代表主站；0代表备站）；主源站必须存在，备源站可选。                                     |
| enable_obs_web_hosting | Integer | 是否开启Obs静态网站托管(0表示关闭,1表示则为开启)，源站类型为obs_bucket时传递。                     |
| http_port              | Integer | HTTP端口，默认80                                                          |
| https_port             | Integer | HTTPS端口，默认443                                                        |
   
 表7DomainOriginHost 
| 参数               | 参数类型   | 描述                  |
|:---|:---|:---|
| domain_id        | String | 域名ID。获取方法请参见查询加速域名。 |
| origin_host_type | String | 回源host的类型。          |
| customize_domain | String | 自定义回源host域名。        |
   
#### 请求示例
```
GET https://cdn.myhuaweicloud.com/v1.0/cdn/domains/12a***********************345d671/detail?enterprise_project_id=1
```
#### 响应示例
**状态码： 200**
OK
```
{
  "domain" : {
    "sources" : [ {
      "domain_id" : "12a***********************345d671",
      "origin_type" : "ipaddr",
      "ip_or_domain" : "10.62.53.75",
      "active_standby" : 1,
      "http_port" : 80,
      "https_port" : 443
    } ],
    "cname" : "www.example1.com.c.example2.com",
    "id" : "12a***********************345d671",
    "user_domain_id" : "1a23***********************4a441",
    "domain_name" : "www.example1.com",
    "business_type" : "web",
    "service_area" : "mainland_china",
    "domain_status" : "online",
    "https_status" : 0,
    "create_time" : 1516861994806,
    "modify_time" : 1532405346365,
    "domain_origin_host" : {
      "domain_id" : "12a***********************345d671",
      "origin_host_type" : "customize",
      "customize_domain" : "www.example4.com"
    },
    "disabled" : 0,
    "locked" : 0,
    "range_status" : "off",
    "follow_status" : "off",
    "origin_status" : "on",
    "auto_refresh_preheat" : 0
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。
