创建加速域名
功能介绍
创建加速域名。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1.0/cdn/domains
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
domain |
是 |
DomainBody object |
创建域名Body |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
domain_name |
是 |
String |
加速域名。（ 由字母（A-Z，a-z，大小写等价）、数字（0-9）和连接符（-）组成，各级域名之间用（.）连接，域名长度不超过75个字符。连接符（-）不能作为域名的开头或结尾字符。） |
business_type |
是 |
String |
域名业务类型，若为web，则表示类型为网页加速；若为download，则表示业务类型为文件下载加速；若为video，则表示业务类型为点播加速；若为wholeSite，则表示业务类型为全站加速。 |
sources |
是 |
Array of Sources objects |
源站配置。 |
service_area |
是 |
String |
域名服务范围，若为mainland_china，则表示服务范围为中国大陆；若为outside_mainland_china，则表示服务范围为中国大陆境外；若为global，则表示服务范围为全球。 |
enterprise_project_id |
否 |
String |
当用户开启企业项目功能时，该参数生效，表示添加加速域名到该企业项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
domain_id |
否 |
String |
加速域名id。 |
ip_or_domain |
是 |
String |
源站IP（非内网IP）或者域名。 |
origin_type |
是 |
String |
源站类型取值：ipaddr：源站IP、 domain：源站域名、obs_bucket：OBS桶域名。源站为ipaddr时，仅支持IPv4，每个源站对应一个源站对象，最多支持50个源站。 |
active_standby |
是 |
Integer |
主备状态，1代表主源站，0代表备源站。 |
enable_obs_web_hosting |
否 |
Integer |
是否开启OBS静态网站托管(0表示关闭,1表示则为开启)，源站类型为obs_bucket时传递。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
domain |
创建域名返回信息。 |
参数 |
参数类型 |
描述 |
|---|---|---|
id |
String |
加速域名ID。 |
domain_name |
String |
加速域名。 |
business_type |
String |
域名业务类型：
|
service_area |
String |
域名服务范围，若为mainland_china，则表示服务范围为中国大陆；若为outside_mainland_china，则表示服务范围为中国大陆境外；若为global，则表示服务范围为全球。 |
user_domain_id |
String |
域名所属用户的domain_id。 |
domain_status |
String |
加速域名状态。取值意义：
|
cname |
String |
加速域名对应的CNAME。 |
sources |
Array of Sources objects |
源站信息。 |
domain_origin_host |
DomainOriginHost object |
域名回源HOST配置。 |
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 |
是否暂停源站回源（off代表关闭 on代表开启）。 |
auto_refresh_preheat |
Integer |
自动刷新预热（0代表关闭；1代表打开）。 |
请求示例
POST https://cdn.myhuaweicloud.com/v1.0/cdn/domains
{
"domain" : {
"domain_name" : "example1.example2.example3.com",
"business_type" : "web",
"sources" : [ {
"ip_or_domain" : "0.0.0.0",
"origin_type" : "ipaddr",
"active_standby" : 1
} ],
"service_area" : "mainland_china",
"enterprise_project_id" : "0"
}
}
响应示例
状态码： 200
OK
{
"domain" : {
"sources" : [ {
"domain_id" : "ff80*************************07b",
"ip_or_domain" : "0.0.0.0",
"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" : "off",
"follow_status" : "off",
"origin_status" : "on",
"auto_refresh_preheat" : 0
}
}
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
错误码
请参见错误码。
