CDN加速

文档中心 API文档 域名管理 单域名恢复CDN加速服务

单域名恢复CDN加速服务

更新时间:2021-06-29 17:42:46

适用产品:通用功能

接口描述

恢复指定域名的CDN加速服务,即从DNS层面让域名请求回到CDN节点。

  • 调用URL: https://open.chinanetcenter.com/api/domain/*/restore
  • 限制说明:·恢复域名CDN加速服务后,该加速域名的配置信息仍保留,使用已有的配置提供加速服务。 ·在恢复加速域名的CDN服务后,可以再取消加速域名的CDN服务。 ·调用频率需控制,可能影响部署性能!
  • 调用频率:300/5min

请求参数

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

返回参数

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

错误码

错误代码(code)描述(message)HTTP状态码语义
NoSuchDomaincustomer not own domain id.404域名不属于当前客户
ForbiddenThe domain is being deleted403域名被删除
DomainNotCanceledThe domain you are trying to restorehasnot been canceled.409您想恢复的域名还没有被取消加速服务
PARAM_INVALIDparam: {0} is null or invalid.400参数{}为空或者无效

示例

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/restore" \
-X "PUT" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml"
返回示例
复制
HTTP/1.1 202 OK
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>