CDN加速

文档中心 API文档 域名配置 查询异步请求任务状态

查询异步请求任务状态

更新时间:2020-11-16 16:59:43
适用产品:通用功能

接口描述

对于域名的新增、修改、启用、禁用、取消、恢复、删除等请求

请求参数

参数名称类型必填描述
cnc-request-idString对于账号每一次请求记录,都会生成唯一的cnc-request-id(适用全部接口),通过该id可以查询每次异步请求任务的执行结果

返回参数

参数名称类型描述
http status codeinthttpstatus=202;   表示成功调用新增域名接口,可使用header中的x-cnc-request-id查看当前新增域名的部署情况
x-cnc-request-idString唯一标示的id,用于查询每次请求的任务 (适用全部接口)
cnc-request-idString本次想要查询的请求记录对应的cnc-request-id
timestampString本次想要查询的请求记录的提交时间,例如:Thu,   09 Nov 2017 22:37:53 CST
async-resultString异步请求的任务执行结果,包括以下4种状态: WAIT:表示该请求等待执行 INPROGRESS:表示该请求执行中 SUCCESS:表示该请求已经执行成功 FAIL:表示该请求执行失败 注意: 1、新建域名的异步请求任务,通过本接口如果查询到结果是执行失败,系统后台会会有重提机制或者人工干预,直到部署成功。 2、修改域名配置的异步请求任务,和新增域名一样,也会有重提机制和人工干预。
async-messageString异步请求的任务执行结果的更多相关信息

错误码

错误代码(code)描述(message)HTTP状态码语义
NoSuchRequestIDThe   specified request id does not exist.404请求任务ID不存在

示例

示例说明
请求示例
复制
#!/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/request/d845d239-27d6-43e4-a8ea-a994df006256" \
-X "GET" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/xml"
返回示例
复制
HTTP/1.1 200 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
<request-log>
  <cnc-request-id>d845d239-27d6-43e4-a8ea-a994df006256</cnc-request-id>
  <timestamp>Wed, 22 Nov 2017 16:33:36 CST</timestamp>
  <async-result>SUCCESS</async-result>
  <async-message/>
</request-log>