CDN加速

文档中心 API文档 域名管理 启用单加速域名

启用单加速域名

更新时间:2019-08-20 17:44:55
适用产品:通用功能

接口描述

启用某个状态为”禁用“的加速域名,使用已有的配置提供加速服务。

  • 调用URL: https://open.chinanetcenter.com/api/domain/*/enable
  • 限制说明:·启用加速域名后,域名的enabled状态变更为true。 ·域名对应的服务单状态如果不正确,或域名处于非法状态,无法正常调用该接口启用加速域名。
  • 调用频率:无限制

请求参数

参数名称类型必填描述
domain-idint加速域名在系统中对应的ID 注意: 1、参看请求示例中的url,123344对应的就是domain-id 2、可以通过【获取域名配置】和【获取域名列表】接口查询到domain-id

返回参数

参数名称类型描述
http status codeinthttpstatus=202;   表示成功调用新增域名接口,可使用header中的x-cnc-request-id查看当前新增域名的部署情况
x-cnc-request-idString唯一标示的id,用于查询每次请求的任务 (适用全部接口)
codeString错误代码,当HTTPStatus不为202时出现,表示当前请求调用的错误类型
messageString响应信息,成功时为success

错误码

错误代码(code)描述(message)HTTP状态码语义
NoSuchDomainThe specified domain does not exist.400指定的域名不存在
ForbiddenThe domain is being deleted403域名已被删除
DomainNotDisabledThe domain you are trying to enable has not been disabled.409域名已启用,不能再次启用。
DomainCanNotEnableDomain cannot enable.409域名不能启用
WRONG_OPERATOROperator [$operator] can not deal with domain name [$domainName].400提交人不能操作域名
NULL_DOMAIN_NAMENo domain.400没有域名
PARAM_INVALIDparam: {0} is null or invalid.400参数{0}为空或非法
CustomerNoOwnDomaincustomer not own domain name[{0}]400域名不属于该客户
InvalidParameterNo domain was specified.400当id或者域名没有传入的时候

示例

示例说明
xml
请求示例
复制
#!/bin/bash
username="example_username"
apiKey="example_apiKey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://open.chinanetcenter.com/api/domain/123344/enable" \
-X "PUT" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml"
返回示例
复制
HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/xml;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <message>success</message>
</response>