文档中心 API文档 删除Url屏蔽接口

删除Url屏蔽接口

更新时间:2020-11-16 18:14:01

适用产品

网页加速、下载分发、动态加速、全站加速、点播分发、直播分发、上传加速、移动加速、上网加速、S-P2P、PCDN、应用性能管理、Web应用防火墙、BotGuard爬虫管理、WSS、DMS、DDoS云清洗、应用安全加速解决方案、IPv6一体化解决方案、电商安全加速解决方案、金融安全加速解决方案、政企安全加速解决方案、应用安全解决方案、区块链安全加速解决方案、IPv6安全加速解决方案

接口描述

删除非法屏蔽url接口

请求参数

Body 参数

JSON/XML
参数名称类型必填描述
domainName
String域名名称
banUrls
List要屏蔽的url列表。可包含多个节点。当存在时,不能被指定为空白。当节点值为true时,节点及其子节点都不能存在。当节点值为false或不存在时,节点及其子节点必须存在,且有值。
url
String要删除的屏蔽url
deleteAll
boolean是否删除域名下所有ban url。可选值为【true:删除所有,false:不删除所有】(忽略大小写)。当存在时,不能被指定为空白。当节点值为true时,节点及其子节点都不能存在。当节点值为false或不存在时,节点及其子节点必须存在,且有值。

返回参数

Body 参数

JSON/XML
参数名称类型描述
code
String错误码
message
String消息体
data
Complex返回数据体,此接口返回的恒为空

错误码

错误代码(code)描述(message)HTTP状态码语义
0success202删除成功
26939999We encountered an system error. Please try again.500系统内部异常,请稍后重试
26938005No domainName was specified.400没有指定域名
26938005The banUrls must be specified if exist.400banUrls如果存在必须被指定值
26938005The banUrls must be specified true or false.400banUrls必须被指定得值只能为true或者false
26938005Cannot specify banUrls if The deleteAll was specified true.400如果deleteAll被指定为true,banUrls不能被指定
26938005The banUrls must be specified if deleteAll is not specified true.400如果deleteAll没有被指定为true,banUrls必须被指定
26938005The specified banUrls is not belong specify domain, domain name:[XXX], banUrls:[XXX,XXX].400指定的url不属于指定的域名
26932001The specified domainName is no exist. domain name:[XXX].400指定的域名不存在
26932002This account not permission to operator the domain. Account:[XXX], Domain:[XXX].400账号没有权限操作域名
26932005The domain is being deleted400域名正在删除中
26932007There are no ban url under this domain. domain name:[XXX].400域名底下没有屏蔽的url
26932006There are urls that have committed to delete tasks but are not deployed. [XXX,XXX]400存在url已经提交删除,但未部署成功
26932008The size of the specified domain add the specified ban urls exceeds the limit. domain name: [XXX], ban urls size: [XXX], limit size: [XXX].400域名添加屏蔽url,入参的url个数超过限定个数

示例

删除非法屏蔽URL-XML
删除非法屏蔽URL-JSON
删除非法屏蔽URL-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/basicconfig/illegalinformation" \
-X "DELETE" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml" \
-H "Content-Type:application/xml"
-d 
'<?xml version="1.0" encoding="utf-8"?>
<domain>
    <domainName>www.example.com</domainName>
    <banUrls>      
            <url>http://www.example.com/ban/url1</url>
            <url>http://www.example.com/ban/url2</url>
   </banUrls>
   <deleteAll>false</deleteAll>
</domain>'
返回示例
复制代码 复制成功
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
x-cnc-deploy-version:1420084740000
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <code>0</code>
  <message>success</message>
  <data></data>
</response>
本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!