CDN加速

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

禁用单加速域名

更新时间:2019-08-20 17:44:55

适用产品:通用功能

接口描述

禁用指定加速域名,禁用后加速域名的请求将被直接拒绝,不会回源。

  • 调用URL: https://open.chinanetcenter.com/api/domain/*/disable
  • 限制说明:·禁用该加速域名后,该加速域名的配置信息仍保留,但针对加速域名的请求将被直接拒绝,不会回源。 ·禁用加速域名后,域名的enabled状态变更为false。 ·若暂时不需要对某域名进行加速,推荐使用另外一个【单域名取消CDN加速服务】接口,暂停域名加速效果。 ·在禁用加速域名后,可以启用加速域名,启用后,域名的ID和配置信息与禁用前保持一致。
  • 调用频率:300/5min

请求参数

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

返回参数

XML
参数名称类型描述
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指定的域名不存在
DomainNotEnabledThe domain you are trying to disable has not been enabled.409您要禁用的域名还未启用
WRONG_OPERATOROperator [$operator] can not deal with domain name [$domainName].400提交人不能操作域名
PARAM_INVALIDparam: {0} is null or invalid.400参数{0}为空或非法
InvalidParameterNo domain was specified.400id或者域名没有传入
CustomerNoOwnDomaincustomer not own domain name[{0}]400域名不属于该客户

示例

XML
示例说明
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/disable" \
-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>