更新时间:2024-03-21 GMT+08:00

启用加速域名

功能介绍

启用加速域名。

URI

PUT /v1.0/cdn/domains/{domain_id}/enable

表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

源站配置。

domain_origin_host

DomainOriginHost object

域名的回源HOST配置。

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桶域名。

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的类型,accelerate:选择加速域名作为回源host域名, customize:使用自定义的域名作为回源host域名。

customize_domain

String

回源host域名。返回加速域名主源站设置的HOST域名,如果加速域名有多个主源站且对应多个回源HOST,则返回源站配置中的第一个主源站对应的HOST域名。

请求示例

PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff80***********************c82722/enable?enterprise_project_id=0

响应示例

状态码: 200

OK

{
      "domain" : {
        "sources" : [ {
          "domain_id" : "ff80***********************c82722",
          "origin_type" : "ipaddr",
          "ip_or_domain" : "0.0.0.0",
          "active_standby" : 1,
          "http_port" : 80,
          "https_port" : 443
        } ],
        "cname" : "www.example1.example2.0002.example3.com.c.example4.com",
        "id" : "ff80808264c7*******fc82722",
        "user_domain_id" : "6e358a************a441",
        "domain_name" : "www.example1.example2.0002.example3.com",
        "business_type" : "web",
        "service_area" : "mainland_china",
        "domain_status" : "configuring",
        "https_status" : 0,
        "create_time" : 1532403213673,
        "modify_time" : 1532403782746,
        "domain_origin_host" : {
          "domain_id" : "ff80***********************c82722",
          "origin_host_type" : "accelerate",
          "customize_domain" : "www.example1.example2.0002.example3.com"
        },
        "disabled" : 0,
        "locked" : 0,
        "range_status" : "off",
        "follow_status" : "off",
        "origin_status" : "on",
        "auto_refresh_preheat" : 0
      }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码