4.1 域名操作
4.1.2 创建加速域名
功能介绍
创建加速域名。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1.0/cdn/domains
请求参数
表4-7 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取(响应消息头中 X-Subject-Token的值)。
表4-8 请求 Body 参数
参数 是否必选 参数类型 描述
domain 是 DomainBody
object 创建域名Body
表4-9 DomainBody
参数 是否必选 参数类型 描述
domain_name 是 String 加速域名。( 国际英文域名:
域名用字母(A-Z,a-z,大小写 等价)、数字(0-9)和连接符
(-)组成,各级域名之间用实 点(.)连接,国际域名75个字 符。注意连接符(-)不能作为 域名的开头或结尾字符。)
参数 是否必选 参数类型 描述
business_type 是 String 域名业务类型,若为web,则表 示类型为网页加速;若为
sources 是 Array of Sources
service_area 是 String 域名服务范围,若为
mainland_china,则表示服务
ject_id 否 String 企业项目ID,创建域名归属的项
目。注意:当使用子账号调用接 口时,该参数必传。
表4-10 Sources
参数 是否必选 参数类型 描述
ip_or_domain 是 String 源站IP(非内网IP)或者域名。
origin_type 是 String 源站类型取值:ipaddr、
domain、obs_bucket,分别表
eb_hosting 否 Integer 是否开启Obs静态网站托管(0表 示关闭,1表示则为开启),源站 类型为obs_bucket时传递。
响应参数
状态码: 200
表4-11 响应 Body 参数
参数 参数类型 描述
domain CreateDomai nResponseBo dyContent object
创建域名返回信息
表4-12 CreateDomainResponseBodyContent
参数 参数类型 描述
id String 加速域名ID。
domain_name String 加速域名。
business_type String 域名业务类型:-web:网站加速;-download:文件 下载加速;-video:点播加速;-wholeSite:全站加 速。
service_area String 域名服务范围,若为mainland_china,则表示服 务范围为中国大陆;若为
outside_mainland_china,则表示服务范围为中 国大陆境外;若为global,则表示服务范围为全 球。
user_domain_i
d String 域名所属用户的domain_id。
domain_statu
s String 加速域名状态。取值意义:online表示“已开 启”、offline表示“已停用”、configuring表示
“配置中”、configure_failed表示“配置失 败”、checking表示“审核中”、check_failed表 示“审核未通过”、deleting表示“删除中”。
cname String 加速域名对应的CNAME。
sources Array of Sources objects
源站信息
domain_origin
_host DomainOrigi
nHost object 域名回源设置信息。
https_status Integer 是否开启HTTPS加速。
create_time Long 域名创建时间,相对于UTC 1970-01-01到当前时 间相隔的毫秒数。
参数 参数类型 描述
modify_time Long 域名修改时间,相对于UTC 1970-01-01到当前时 间相隔的毫秒数。
disabled Integer 封禁状态(0代表未禁用;1代表禁用)。
locked Integer 锁定状态(0代表未锁定;1代表锁定)。
range_status String range状态("off"/"on")。
follow_status String follow302状态("off"/"on")。
origin_status String 是否暂停源站回源。
auto_refresh_
preheat Integer 自动刷新预热(0代表关闭;1代表打开)
表4-13 Sources
参数 参数类型 描述
ip_or_domain String 源站IP(非内网IP)或者域名。
origin_type String 源站类型取值:ipaddr、 domain、
obs_bucket,分别表示:源站IP、源站域名、
OBS桶访问域名。
active_standb
y Integer 主备状态(1代表主站;0代表备站),主源站必须
存在,备源站可选,OBS桶不能有备源站。
enable_obs_w
eb_hosting Integer 是否开启Obs静态网站托管(0表示关闭,1表示则为 开启),源站类型为obs_bucket时传递。
表4-14 DomainOriginHost
参数 参数类型 描述
domain_id String 域名ID。获取方法请参见查询加速域名。
origin_host_ty
pe String 回源host的类型。
customize_do
main String 自定义回源host域名。
请求示例
POST https://cdn.myhuaweicloud.com/v1.0/cdn/domains { "domain" : {
"domain_name" : "example1.example2.example3.com",
"business_type" : "web", "sources" : [ {
"ip_or_domain" : "10.62.53.75", "origin_type" : "ipaddr", "active_standby" : 1 } ],
"service_area" : "mainland_china", "enterprise_project_id" : "0"
}} "ip_or_domain" : "10.62.53.75",
"origin_type" : "ipaddr", "active_standby" : 1 } ],
"id" : "ff80*************************07b",
"user_domain_id" : "38***********************5024dcb", "domain_name" : "example11.example2.example3.com", "business_type" : "web",
"service_area" : "mainland_china",
"cname" : "example1.example2.example3.com.c.example4.com", "domain_status" : "configuring",
"https_status" : 0,
"create_time" : 1513152634467, "modify_time" : 1513152634467, "domain_origin_host" : {
"domain_id" : "ff80*************************07b", "origin_host_type" : "customize",
"customize_domain" : "example5.example6.com"
},
"disabled" : 0, "locked" : 0,
"range_status" : false, "follow_status" : false, "origin_status" : true, "auto_refresh_preheat" : 0 }}