更新时间:2024-05-07 GMT+08:00
分享

查询加速域名详情

功能介绍

查询加速域名详情。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1.0/cdn/domains/{domain_id}/detail

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

String

加速域名ID。获取方法请参见查询加速域名。

表2 Query参数

参数

是否必选

参数类型

描述

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

域名信息

表5 DomainsWithPort

参数

参数类型

描述

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。

表6 SourceWithPort

参数

参数类型

描述

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

表7 DomainOriginHost

参数

参数类型

描述

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

错误码

请参见错误码

相关文档