预部署高级源配置接口

更新时间:2023-12-14 18:56:49

适用产品

网页加速、下载分发、全站加速、应用安全加速解决方案、IPv6一体化解决方案、电商安全加速解决方案、金融安全加速解决方案、政企安全加速解决方案、应用安全解决方案、区块链安全加速解决方案、IPv6安全加速解决方案、点播分发、直播分发、移动加速

接口描述

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

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

调用频率

单用户调用频率:300/5min

请求参数

Body 参数

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。如果有标签,则此项必填.支持多个。 推荐入参是大洲粒度的,其他粒度的数据存在调整的风险----请慎用
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:不开启 清空:网页加速、全站加速默认为开启;其他服务默认为关闭
default-source-hostString
回源请求HOST
src-portString
回源请求端口

返回参数

Body 参数

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

示例

JSON
XML
JSON
请求示例
复制代码 复制成功
#!/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",
    "default-source-host":"1.1.1.1",
    "src-port":"80",
    "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"}
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!