CDN加速

文档中心 API文档 域名配置 预部署高级源配置接口

预部署高级源配置接口

更新时间:2021-06-29 18:39:05

适用产品:网页加速、下载加速、全站加速、点播加速、直播加速、移动加速、云存储

接口描述

通过接口自助修改高级源配置。允许客户指定区域配置,不同的IP回源,以及多源时候,可以指定策略回源。

  • 调用URL: https://open.chinanetcenter.com/api/predeploy/advancedsource/*
  • 限制说明:· 加速域名必须已备案完成。 · 加速域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。 · 视频类加速域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。 · 接口请求和返回结果接受xml和json格式。
  • 调用频率:300/5min

请求参数

XML
参数名称类型必填描述
origin-ipString回源地址,可以是IP或域名。 1、IP以分号分隔,支持多个。 2、域名只能输入一个。IP与域名不能同时输入。 3、限制最大不能超过500个字符长度。
use-advanced-sourcesString是否开启高级源配置,此项必填。 true:开启 false:不开启 如果要清空配置可以传入false.
advanced-sourcescomplex高级源配置标签 注意:表示需要设置高级源配置时,此项必填
advanced-sourcecomplex高级源配置,表示一条高级源。客户可以配置多条高级源内容。
advanced-source-strategiescomplex高级源扩展配置,可以指定一条高级源配置下多个IP时,访问策略。支持多个,
advanced-source-strategystring高级源扩展配置,可以指定一条高级源配置下多个IP时一种访问策略,多种策略可以多个参数 port:用请求端口回源 primary:主源轮询(需要与技术支持同事确认) standby:备源轮询(需要与技术支持同事确认)
areascomplex需要设置高级源的区域。具体见附件。输入值未区域对应的英文值。一定要有一条全球区域的配置,全球输入Global。如果有<advanced-source>标签,则此项必填.支持多个。 推荐入参是大洲粒度的,其他粒度的数据存在调整的风险----请慎用
areastring一组区域配置,如果有多个则,参数多个。
adv-ipsstring一个区域下配置回源IP信息,如果一个区域有多个IP则有多组
adv-ipString一组IP信息
ipString回源IP。支持IP或域名;如果是IP支持IPV4和IPv6,值只能一个
priorityint层级。指定这个回源IP的层级,不输入默认一层
weightint权重。指定这个回源IP的权重,不输入默认10
source-hoststring回源host,支持ip和域名,值只支持一个(动态源不支持)
authorization-methodstring鉴权方式,可选值OSS、TOS、Amazon S3 (动态源不支持,必须设置use-dynamic-sources=false)
use-dynamic-sourcesString开启动态源,部分配置项不支持动态源 true:开启 false:不开启 清空:网页加速、全站加速默认为开启;其他服务默认为关闭

返回参数

PRE-DEPLOYMENT TASK ID
参数名称类型描述
preDeployIdString预部署任务的id,可以根据这个id查询预部署的进展和结果

示例

JSON
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/predeploy/advancedsource/123344" \
-X "PUT" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-H "Content-Type:application/json" \
-d '
{
    "origin-ip":"127.0.1.1;127.0.2.1;127.0.4.1;127.0.5.1",
    "use-advanced-sources":"true",
     "use-dynamic-sources":"false",
    "advanced-sources":[
        {
            "advanced-source-strategies":[
                "primary",
                "standby"
            ],
            "areas":[
                "Global",
                "Japan"
            ],
            "adv-ips":[
                {
                    "ip":"127.0.1.1",
                    "priority":"1",
                    "weight":"10",
                    "source-host": "sourcehost1.example.com"
                },
                {
                    "ip":"127.0.2.1",
                    "priority":"2",
                    "weight":"9",
                    "source-host": "sourcehost2.example.com"
                }
            ]
        },
        {
            "advanced-source-strategies":[
                "standby"
            ],
            "areas":[
                "China"
            ],
            "adv-ips":[
                {
                    "ip":"127.0.4.1",
                    "priority":"1",
                    "weight":"10"
                },
                {
                    "ip":"127.0.5.1",
                    "priority":"2",
                    "weight":"9"
                }
            ]
        }
    ]
}'
返回示例
复制
HTTP/1.1 202 OK 
Server: openresty/1.11.2.2
Date: Thu, 14 Mar 2019 08:09:45 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 31
Connection: keep-alive
App-Name: service_confApi
x-cnc-request-id: 86f908a5-3e45-4be3

{"preDeployId":"66201667e7424820b9e359671178757c"}