域名管理接口API文档

Size: px

Start display at page:

Download "域名管理接口API文档"

比卜
5 years ago
Views:

1 内容分发网络域名管理接口 API 文档

2 版权声明腾讯云版权所有本文档著作权归腾讯云单独所有, 未经腾讯云事先书面许可, 任何主体不得以任何形式复制修改抄袭传播全部或部分本文档内容商标声明及其它腾讯云服务相关的商标均为腾讯云计算 ( 北京 ) 有限责任公司及其关联公司所有本文档涉及的第三方主体的商标, 依法由权利人所有服务声明本文档意在向客户介绍腾讯云全部或部分产品服务的当时的整体概况, 部分产品服务的内容可能有所调整您所购买的腾讯云产品服务的种类服务标准等应由您与腾讯云之间的商业合同约定, 除非双方另有约定, 否则, 腾讯云对本文档内容不做任何明示或模式的承诺或保证第 2 页共 36 页

3 文档目录文档声明... 2 新增加速域名... 4 启动 CDN 域名... 8 关闭 CDN 域名删除加速域名修改源站配置修改域名配置设置缓存规则切换域名所属项目第 3 页共 36 页

4 新增加速域名 1. 接口描述本接口 (AddCdnHost) 用于新增加速域名接口请求域名 :cdn.api.qcloud.com 1) 接入的域名必须尚未接入腾讯云 CDN; 2) 接入的域名必须通过工信部备案 ; 3) 使用此接口, 一次仅可添加一个域名至腾讯云 CDN 2. 输入参数参数名称是否必选类型描述 host 是 String 需要接入 CDN 的域名 projectid 是 String 项目 ID, 指域名要添加入的项目的对应 ID hosttype 是 String 域名的接入方式, 只有两种取值方式, 若为 'cname', 则表示用户使用自己的源站 ; 若为 'ftp', 则表示用户使用 CDN 提供的 FTP 托管源 ; 注意 : 若选择 ftp 则无需填充源站配置 origin 否 String 源站设置, 支持配置一个域名, 或配置多个源站 IP( 支持 'ip:port' 类型, 如 :8080), 端口仅支持大于 0 小于等于输出参数第 4 页共 36 页

5 参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 4. 示例 4.1 输入示例 host: projectid: 0 hosttype: cname origin: GET 请求 GET 请求需要将所有参数都加在 URL 后 : https: //cdn.api.qcloud.com/v2/index.php?nonce= &timestamp= &action=ad dcdnhost&secretid=xxxxxxxxxxxxxxxxxxxxxxxxx&host= pe=cname&origin= &signature=xxxxxxxxxxxxxxxxxxxxxxxxxx 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 第 5 页共 36 页

6 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'AddCdnHost', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'host' => ' 'projectid' => '0', 'hosttype' => 'cname', 'origin' => ' ', 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', ) 4.4 返回结果示例添加成功 "code": 0, "message": "" } 添加失败 "code": 4000, "message": "(20004) 未备案 cdn audit no icp[cdn audit no icp[ 当前域名未在工信部备案 ]]" } 第 6 页共 36 页

7 PHP&Python 示例下载示例代码 PHP&Python 新版第 7 页共 36 页

8 启动 CDN 域名 1. 接口描述本接口 (OnlineHost) 用于启动指定的 CDN 域名接口请求域名 :cdn.api.qcloud.com 1) 一次仅支持一个域名的启动操作 ; 2) 该功能主要针对处于关闭状态的域名进行 2. 输入参数参数名称是否必选类型描述 hostid 是 Int 指定需要启动的域名 ID 注意事项可使用接口根据域名查询域名信息查询域名信息获取 host 对应的 ID; 域名状态为部署中时调用启动 API 会返回失败 3. 输出参数参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 4. 示例 4.1 输入示例 hostid: 1234 第 8 页共 36 页

9 4.2 GET 请求 GET 请求需要将所有参数都加在 URL 后 : https: //cdn.api.qcloud.com/v2/index.php?nonce= &timestamp= &action=on linehost&secretid=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx&hostid=1234&signature=xxxxxxxxxx XXXXXXXXXXX 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'OnlineHost', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX', 'hostid' => 1234 ) 4.4 返回结果示例第 9 页共 36 页

10 启动成功 "code":0, "message":"" } 启动失败 "code": 4000, "message": "(9175) 部署中状态 cdn host in progress[host in progress]" } PHP&Python 示例下载示例代码 PHP&Python 新版第 10 页共 36 页

11 关闭 CDN 域名 1. 接口描述本接口 (OfflineHost) 用于关闭指定的 CDN 域名接口请求域名 :cdn.api.qcloud.com 1) 一次仅允许关闭一个 CDN 域名 ; 2) 域名关闭后, 对此域名的资源访问会统一返回输入参数参数名称是否必选类型描述 hostid 是 Int 需要关闭的域名 ID 注意事项可使用接口根据域名查询域名信息查询域名信息获取 host 对应的 ID; 状态为部署中的域名调用关闭 API 会返回失败 3. 输出参数参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 4. 示例 4.1 输入示例 hostid: 1234 第 11 页共 36 页

12 4.2 GET 请求 GET 请求需要将所有参数都加在 URL 后 : https: //cdn.api.qcloud.com/v2/index.php?nonce= &timestamp= &action=of flinehost&secretid=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx&hostid=1234&signature=xxxxxxxxx XXXXXXXXXXXX 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'OfflineHost', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX', 'hostid' => 1234 ) 4.4 返回结果示例第 12 页共 36 页

13 关闭成功 "code":0, "message":"" } 关闭失败 "code": 4000, "message": "(9175) 部署中状态 cdn host in progress[host in progress]" } PHP&Python 示例下载示例代码 PHP&Python 新版第 13 页共 36 页

14 删除加速域名 1. 接口描述本接口 (DeleteCdnHost) 用于删除指定的 CDN 域名接口请求域名 :cdn.api.qcloud.com 1) 一次仅支持删除一个域名 ; 2) 只有关闭状态的域名才可以进行删除操作 2. 输入参数参数名称是否必选类型描述 hostid 是 Int 需要删除的域名 ID 注意事项可使用接口根据域名查询域名信息查询域名信息获取 host 对应的 ID; 关闭状态的 COS 同步而来的只读域名, 如.file.myqcloud.com 后缀域名也可以删除 3. 输出参数参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 4. 示例 4.1 输入示例 hostid: 1234 第 14 页共 36 页

15 4.2 GET 请求 GET 请求需要将所有参数都加在 URL 后 : https: //cdn.api.qcloud.com/v2/index.php?nonce= &timestamp= &action=de letecdnhost&secretid=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx&hostid=1234&signature=xxxxxxx XXXXXXXXXXXXXX 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'DeleteCdnHost', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'hostid' => 1234, 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX=', ) 4.4 返回结果示例第 15 页共 36 页

16 删除成功 "retcode": 0, "errmsg": "ok", "data": [], "code": 0, "message": "" } 删除失败 "code": 5100, "message": " 请求 CDN 接口错误 :cdn no such host:9110" } PHP&Python 示例下载示例代码 PHP&Python 新版第 16 页共 36 页

17 修改源站配置 1. 接口描述本接口 (UpdateCdnHost) 用于修改域名对应源站配置接口请求域名 :cdn.api.qcloud.com 1) 状态为下线部署中的域名不可修改源站配置 ; 2) 一次仅支持修改一个域名对应的源站配置 2. 输入参数参数名称是否必选类型描述 origin 是 String 可填写一个源站域名, 或者多个源站 IP( 支持 'ip:port' 类型, 如 :8080), 端口仅支持大于 0 小于等于 hostid 是 Int 需要配置源站的域名 ID host 是 String 需要配置源站的域名 host 注意事项可使用接口根据域名查询域名信息查询域名信息获取 host 对应的 ID 3. 输出参数参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 data Array 输出结果, 配置源站的域名对应的详第 17 页共 36 页

18 参数名称类型描述细信息 data 字段说明参数名称类型描述 hosts Array 域名信息数组, 详情见下文说明 total Int 域名总数 hosts 字段说明参数名称类型描述 id Int 域名接入 CDN 后的的标识 ID app_id Int 域名归属人对应的 APPID owner_uin Int 用户登录腾讯云时, 使用的 QQ 账号 project_id Int 域名所属项目 ID host String 域名 host_type String 接入方式, 共有三种类型, 若为 'cos ', 则表示域名接入时使用的托管源为 COS 源 ; 若为 'cname', 则表示域名接入时使用的是自有源站 ; 若为 'ft p', 则表示该域名接入时使用了 CDN 提供的 FTP 托管源 service_type String 域名业务类型, 共有四种类型, 若为 'file', 则表示类型为网页图片 / 小文件 ; 若为 'download', 则表示类型为大文件下载 ; 若为 'vod', 则表示类型为流媒体点播 ; 若为 'live', 则表示类型为流媒体直播 origin String 域名对应源站配置 cache Array 缓存规则设置, 详细说明见下文 disabled Int 域名是否被封禁, 若为 '0', 则表示域名未被封禁 message String 域名状态信息, 如 ' 已关闭 ' ' 已启动 ' ' 部署中 ' 等第 18 页共 36 页

19 参数名称类型描述 enable_overseas String 是否开启海外 CDN, 若为 'no', 表示域名未开启海外 CDN; 若为 'yes', 则表示该域名开启了海外 CDN create_time String 域名接入时间 update_time String 上一次更新时间 deleted String 是否删除, 若为 'no', 则表示域名未被删除 ; 若为 'yes', 则表示域名已经被删除 fwd_host_type String 回源设置类型, 若为 'default', 则表示接入的域名即回源地址 ; 若为 'cus tom', 则该域名使用了自定义的回源地址 fwd_host String 回源地址 middle_resource Int 中间源设置, 若为 '-1', 则表示该域名关闭了中间源服务 ; 若为 '0', 则表示该域名开启了中间源服务 refer Array 防盗链设置, 详细说明见下文 readonly Int 是否只读, 若为 1, 表示域名为只读, 目前 COS 同步而来的.file.myqcloud.com 后缀域名为只读态 ; 若为 0, 则域名可读写 cname String CDN 分配的.cdn.dnsv1.com 后缀加速域名 cache_mode String 缓存规则类型, 若为 'simple', 则表示缓存完全依赖控制台设置 ; 若为 'c ustom', 则表示缓存依赖控制台设置的缓存时间和源站吐出的 maxage 的最小值 furl_cache String 过滤参数, 若为 'on', 则表示开启 ; 若为 'off', 则表示关闭 ssl_type Int 是否开通 HTTPS, 若为 0, 则表示未开通 HTTPS 配置 ; 若为其他, 则表示已开通 HTTPS 配置第 19 页共 36 页

20 参数名称类型描述 bucket_name String COS 源时, 对应的 bucket 名称 ssl_deploy_time String SSL 部署时间 ssl_expire_time String SSL 过期时间 host_id Int host 对应 ID, 与 id 相同 cache 字段说明参数名称类型描述 type Int 类型, 共有四种类型, 其中 0 表示所有文件,1 表示文件类型,2 表示文件夹类型,3 表示全路径文件 rule String 匹配规则, 与上述 type 相对应 time Int 缓存时间, 单位为秒 unit String 设置缓存时间时所用单位, 共有四种类型,'d' 表示天,'h' 表示小时,'m' 表示分钟,'s' 表示秒 refer 字段说明参数名称类型描述 type Int 防盗链类型, 共有三种类型,0 表示未配置防盗链,1 表示配置的名单为黑名单,2 表示配置的名单为白名单 null_flag Int 防盗链是否为空, 若为 1, 则表示防盗链为空 list Array 配置的防盗链名单注意事项 : 未在上述文档中说明的字段均为无效字段, 可直接忽略 4. 示例 4.1 输入示例第 20 页共 36 页

21 host: hostid: 1234 origin: ; GET 请求 GET 请求需要将所有参数都加在 URL 后 : &Action=Update CdnHost&SecretId=XXXXXXXXXXX XXXXXXXXXXXXXXXX&hostId=1234&host= &Signature=XXXXXXXXXXXXXXXXXXXXXXXXXXXXX 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'UpdateCdnHost', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'host' => ' 第 21 页共 36 页

22 'hostid' => '1234', 'origin' => ' ; ', 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX', ) 4.4 返回结果示例修改成功 "retcode": 0, "errmsg": "ok", "data": [ "id": 1234, "app_id": , "owner_uin": , "cdn_bu_id": , "project_id": 0, "host": " "host_type": "cname", "service_type": "file", "origin": " ; ", "cache": [ "type": 0, "rule": "all", "time": , "unit": "s" }, "type": 1, "rule": ".php;.jsp;.asp;.aspx", 第 22 页共 36 页

23 "time": 0, "unit": "s" } ], "status": 4, "disabled": 0, "message": " 部署中 ", "validate_string": "xxxxxxxxxxxxxxxxxxxxxxxxxx", "enable_autofresh": "no", "enable_overseas": "no", "create_time": " :20:55", "update_time": " :35:38", "deleted": "no", "fwd_host_type": "default", "fwd_host": " "middle_resource": -1, "middle_config": 1, "refer": "type": 0, "list": [], "null_flag": 1 }, "readonly": 0, "cname": " "cache_mode": "custom", "channel": "cdn", "furl_cache": "on", "authtime": null, "authcode": -1, "authmsg": "", "lock_time": null, "version": 5, "extension": "", "co_channel": "cdn", 第 23 页共 36 页

24 "ssl_type": 0, "ssl_domain": null, "ssl_pid": 0, "platform": "sp", "bucket_name": "", "ssl_deploy_time": null, "ssl_expire_time": null, "ssl_status": 0, "ssl_auth_method": "FILE", "ssl_ ": "", "cdn_date": " :00:00", "lock_msg": null, "host_id": 1234 } ], "code": 0, "message": "" } 修改失败 "code": 5100, "message": " 请求 CDN 接口错误 :cdn not host owner[success]:9105" } PHP&Python 示例下载示例代码 PHP&Python 新版第 24 页共 36 页

25 修改域名配置 1. 接口描述本接口 (UpdateCdnConfig) 用于修改域名对应的配置信息接口请求域名 :cdn.api.qcloud.com 1) 一次仅支持修改一个域名的配置信息 ; 2) 可对指定域名的缓存规则缓存类型防盗链回源 HOST 源站等配置信息进行修改 ; 3) 此接口包括了修改源站配置修改缓存规则的功能 2. 输入参数参数名称是否必选类型描述 hostid 是 Int 要设置的域名对应 ID projectid 否 Int 要设置的域名对应的项目 ID cache 否 JSON String 缓存配置, 详细说明见下文 cachemode 否 String 缓存模式, 共有两种类型, 其中 'simple' 表示缓存完全依赖控制台设置 ; 若为 'cus tom', 则表示缓存依赖控制台设置的缓存时间和源站吐出的 maxage 的最小值 refer 否 JSON String 防盗链设置, 详细说明见下文 fwdhost 否 String 回源 Host,CDN 节点回源时所带的 HTTP 头部 host 参数 fullurl 否 String 全 URL 缓存 ; 共有两种类型, 其中 'on' 表示开启全路径缓存第 25 页共 36 页

26 参数名称是否必选类型描述 origin 否 String 源站设置 'off' 表示关闭全路径缓存详细说明 refer 防盗链设置示例 : [1,["qq.baidu.com", "*.baidu.com"]] 第一个字段标识 refer 类型 : 0: 不设置防盗链 ; 1: 设置黑名单 ; 2: 设置白名单 ; 第二个字段为具体的名单列表缓存规则设置 cache 设置示例如下 : [[0,"all",1000],[1,".jpg;.js",2000],[2,"/www/html",3000],[3, "/index.html;/test/*.jpg",3000]] 第一个参数是缓存类型 : 缓存类型有如下四种 : 0: 全部类型, 表示匹配所有文件, 默认缓存配置 ; 1: 文件类型, 表示按文件后缀匹配 ; 2: 文件夹类型, 表示按目录匹配 ; 第 26 页共 36 页

27 3: 全路径文件, 标识按照首页或指定某一文件匹配第二个参数指定匹配规则 : 0: 固定填充 all ; 1: 后缀,.jps;.js 等,; 分隔 ; 2: 目录, 如 /www/html; /www/anc/ 等,; 分隔 ; 3: 全路径文件, 如 /index.html;/test/*.jpg 等资源全路径,; 分隔, 仅支持 * 匹配第三个参数指定缓存时间, 单位为秒 3. 输出参数参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 4. 示例 4.1 输入示例 hostid: 1234 cache: [[0,"all",1000],[1,".jpg;.js",2000],[2,"/www/html",3000]] cachemode: custom refer: [1,["qq.baidu.com", "*.baidu.com"]] 4.2 GET 请求 GET 请求需要将所有参数都加在 URL 后 : 第 27 页共 36 页

28 https ://cdn.api.qcloud.com/v2/index.php?nonce= &timestamp= &action=u pdatec dnconfig&sec retid=xxxxxxxxxxxxxxxxxx XXXXXXXXXXX&hostId=207868&cache=%5B%5B0%2C%22all%22%2C1000%5D%2C%5B1%2C%22.jpg%3B.js%22%2C2000%5D%2C%5B2%2C%22%2Fwww%2Fhtml%22%2C3000%5D%5 D&cacheMode=custom&refer=%5B1%2C%5B%22qq.baidu.com%22%2C+%22%2 A.baidu.com%22%5D%5D&Signature=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'UpdateCdnConfig', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'hostid' => '207868', 'cache' => '[[0,"all",1000],[1,".jpg;.js",2000],[2,"/www/html",3000]]', 'cachemode' => 'custom', 'refer' => '[1,["qq.baidu.com", "*.baidu.com"]]', 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', ) 4.4 返回结果示例第 28 页共 36 页

29 设置成功 "code": 0, "message": "" } 设置失败 "code": 4000, "message": "(9176) 域名已下线 cdn host offline[host offline]" } PHP&Python 示例下载示例代码 PHP&Python 新版第 29 页共 36 页

30 设置缓存规则 1. 接口描述本接口 (UpdateCache) 用于修改指定域名的缓存规则配置接口请求域名 :cdn.api.qcloud.com 1) 一次仅支持修改一个域名的缓存规则 ; 2) 下线部署中状态的域名不可修改缓存规则 ; 3) 支持一次设置多条缓存规则 2. 输入参数参数名称是否必填类型描述 hostid 是 Int 指定修改配置的域名对应 ID cache 是 JSON String 缓存规则配置详细说明 cache 设置示例如下 : [[0,"all",1000],[1,".jpg;.js",2000],[2,"/www/html",3000],[3, "/index.html;/test/*.jpg",3000]] 第一个参数是缓存类型 : 缓存类型有如下四种 : 0: 全部类型, 表示匹配所有文件, 默认缓存配置 ; 1: 文件类型, 表示按文件后缀匹配 ; 2: 文件夹类型, 表示按目录匹配 ; 3: 全路径文件, 标识按照首页或指定某一文件匹配第 30 页共 36 页

31 第二个参数指定匹配规则 : 0: 固定填充 all ; 1: 后缀,.jps;.js 等,; 分隔 ; 2: 目录, 如 /www/html; /www/anc/ 等,; 分隔 ; 3: 全路径文件, 如 /index.html;/test/*.jpg 等资源全路径,; 分隔, 仅支持 * 匹配第三个参数指定缓存时间, 单位为秒注意事项可使用接口根据域名查询域名信息查询域名信息获取 host 对应的 ID; 3. 输出参数参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 4. 示例 4.1 输入示例 hostid: 1234 cache: [[0,"all",1000],[1,".jpg;.js",2000],[2,"/www/html",3000]] 4.2 GET 请求 GET 请求需要将所有参数都加在 URL 后 : 第 31 页共 36 页

32 https ://cdn.api.qcloud.com/v2/index.php?nonce= &timestamp= &action=u pdatecache&secre tid=xxxxxxxxxxxxxxxxxxxxxxxxx&ho stid=1234&cache=%5b%5b0%2c%22all%22%2c1000%5d%2c%5b1%2c%22.jpg%3b.js%22%2 C2000%5D%2C%5B2%2C%22%2Fwww%2Fhtml%22%2C3000%5D%5 D&Signature=eBAJQT%2BbWkXlGhbXaCbO9sXaf38%3D 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'UpdateCache', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'hostid' => '1234', 'cache' => '[[0,"all",1000],[1,".jpg;.js",2000],[2,"/www/html",3000]]', 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', ) 4.4 返回结果示例修改成功第 32 页共 36 页

33 "code": 0, "message": "" } 修改失败 "code": 4000, "message": "(9176) 域名已下线 cdn host offline[host offline]" } PHP&Python 示例下载示例代码 PHP&Python 新版第 33 页共 36 页

34 切换域名所属项目 1. 接口描述本接口 (UpdateCdnProject) 用于切换域名所属项目接口请求域名 :cdn.api.qcloud.com 2. 输入参数参数名称是否必选类型描述 projectid 是 Int 需要设置的对应项目 ID hostid 是 Int 域名 ID 注意事项可使用接口根据域名查询域名信息查询域名信息获取 host 对应的 ID 3. 输出参数参数名称类型描述 code Int 公共错误码,0 表示成功, 其他值表示失败详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 4. 示例 4.1 输入示例 hostid: 1234 projectid: 0 第 34 页共 36 页

35 4.2 GET 请求 GET 请求需要将所有参数都加在 URL 后 : https: //cdn.api.qcloud.com/v2/index.php?nonce= &timestamp= &action=up datecdnproject&secretid=xxxxxxxxxxxxxxxxxxxxxxxxxxxx&hostid=1234&projectid=0&sig nature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 4.3 POST 请求 POST 请求时, 参数填充在 HTTP Request-body 中, 请求地址 : 参数支持 form-data x-www-form-urlencoded json 等格式, 参数数组如下 : array ( 'Nonce' => , 'Timestamp' => , 'Action' => 'UpdateCdnProject', 'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX', 'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX', 'projectid' => '0', "hostid" => '1234' ) 4.4 返回结果示例第 35 页共 36 页

36 Powered by TCPDF ( 切换成功 "code":0, "message":"" } 切换失败 "code": 4000, "message": "(9003) 参数错误 param error[invalid project id]" } PHP&Python 示例下载示例代码 PHP&Python 新版第 36 页共 36 页

域名管理接口API文档

域名管理接口API文档内容分发网络域名管理接口 API 文档版权声明 2015-2016 腾讯云版权所有本文档著作权归腾讯云单独所有, 未经腾讯云事先书面许可, 任何主体不得以任何形式复制修改抄袭传播全部或部分本文档内容商标声明及其它腾讯云服务相关的商标均为腾讯云计算 ( 北京 ) 有限责任公司及其关联公司所有本文档涉及的第三方主体的商标, 依法由权利人所有服务声明本文档意在向客户介绍腾讯云全部或部分产品