修改调度域名的配置（增量配置修改）-网宿科技

返回文档中心

API中心

适用产品

CDN Pro

接口描述

使用该接口对调度域名的部分字段进行更新。

调用URL： https://open.chinanetcenter.com/cdn/edgeHostnames/*
调用方法：PATCH

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Path 参数

参数名称	描述
*edgeHostnameString	调度域名。

Body 参数

参数名称	描述
descriptionString	调度域名的描述。
pciRequiredBoolean	表示流量调度是否需要遵循PCI规范。当值为true时，表示只能使用已通过PCI认证的节点提供内容分发服务。
grprCompliantBoolean	表示流量调度是否需要遵循GDPR的规定。当值为'true'时，对于来自欧洲经济区(EEA)国家的请求，将仅使用归属EEA国家的IP地址提供服务。
- clientZonesList	自定义规则来控制如何处理不同访客分区的请求。您必须至少创建一条覆盖所有区域和所有运营商的规则。
regionString	该规则适用的区域。可调用'查询支持的区域列表'接口来查看区域信息。例如，如果您希望创建规则覆盖整个欧洲，则指定'eu'为区域。您可以指定具体的国家。例如，'na.us'代表'美国'，而'eu.fr'代表'法国'。 'all'是一个特殊的区域，可用于指定适用于全球的规则。如果不同规则指定的区域存在重叠，则以更细粒度的区域优先。例如，如果您在一条规则中指定'as'，在另一条规则中指定'as.cn'，则来自中国的请求将优先匹配'as.cn'的规则。
weightInteger	默认值: 100 取值范围: [ 0 .. 100 ] 可以为同个访客分区指定多条规则。通过在规则中指定weight字段，可控制规则匹配的权重。以'as.cn'区域的2条规则为例: {'region':'as.cn', 'isp':'all', 'action':{'type':'deliver', 'by':['standard', 'premium', 'deluxe']}}, {'region':'as.cn', 'isp':'all', 'action':{'type':'redirect', 'to':['alternate.cname.com']}, 'weight':10} 按照以上规则，客户端请求匹配规则1进行'分发'的比例为100/(100+10)，即0.909，匹配规则2进行'跳转'的比例为10/(100+10)，即0.091。
- actionUpdateAnEdgeHostnamePartRequestClientZonesAction	当规则匹配时执行的动作。
*typeString	取值范围: deliver,redirect,reject 当规则匹配时，对客户端请求执行的动作的类型。包括分发，拒绝和跳转3个类型。如果指定了'拒绝'，则客户端请求将被调度到一台服务器，该服务器总是响应403状态码，表示'Forbidden'拒绝访问。每个访客分区最多只允许一个'拒绝'动作。
byList	如果动作类型为'分发'，则使用此字段指定一个或多个节点组(standard, premium, deluxe, ultra, nearChina, ChinaStandard, ChinaPremium) 来选择提供内容分发服务的缓存节点。如果未指定，则使用'standard'。 'nearChina' 是一个特殊的节点组。如果您需要使用nearChina节点组，请联系我们的技术支持开通。不能在同一条规则中同时指定nearChina节点组和其他节点组。如果要使用其他节点组，需要创建单独的访客分区规则。如果您的加速域名有ICP备案，希望由中国大陆的服务器提供内容分发服务，您可以选择使用'ChinaStandard'和'ChinaPremium'节点组。如果调度域名创建时没有指定使用ChinaStandard或ChinaPremium节点组，则无法通过更新调度域名来使用这两个节点组。您需要创建一个新的调度域名，在新的调度域名中指定使用ChinaStandard或ChinaPremium，才能使用这2个节点组。
toList	如果动作类型为'跳转'，则通过该字段指定跳转的目标域名或IP地址。'跳转'目标通常是源站服务器或其它CDN厂商。
enableIPv6Boolean	默认值: True 指定是否允许使用IPv6地址进行内容分发。仅当动作类型为'分发'时该值才有效。
ispString	该规则适用的运营商。可调用我们的'查询支持的ISP运营商列表'接口查看运营商信息。指定'all'表示所有运营商。如果希望该规则应用于多个运营商，则可指定多个运营商，用逗号分隔，但最多只能包含10个运营商。
estimatedBandwidthString	通过该调度域名进行CDN加速预计需要的带宽。单位应为Tbps、Gbps、Mbps或kbps。示例：100 Gbps。

错误码

错误代码（code）	描述（message）	HTTP状态码	语义
InvalidClientZone	Invalid client region 'abc'.	400	指定的区域无效。
InvalidISP	Invalid ISP 'abcdef'.	400	指定的ISP无效。
InvalidEdgeHostname	The specified edge hostname does not exist or the caller doesn't have access to this resource.	404	指定的调度域名不存在，或者您无访问权限。
EdgeHostnameChangeForbidden	The edge hostname cannot be changed.	409	调度域名禁止更新。

示例

400

请求示例 复制代码 复制成功#!/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/cdn/edgeHostnames/{edgeHostname}" \ -X "PATCH" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{"description": "This is a new edge hostname for use with our property."}'

#!/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/cdn/edgeHostnames/{edgeHostname}" \
-X "PATCH" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{"description": "This is a new edge hostname for use with our property."}'

返回示例 复制代码 复制成功{ "code": "InvalidClientZone", "message": "Invalid client region 'abc'." }

{
    "code": "InvalidClientZone",
    "message": "Invalid client region 'abc'."
}

404

请求示例 复制代码 复制成功#!/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/cdn/edgeHostnames/{edgeHostname}" \ -X "PATCH" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d {'description': 'This is a new edge hostname for use with our property.'} \

#!/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/cdn/edgeHostnames/{edgeHostname}" \
-X "PATCH" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d {'description': 'This is a new edge hostname for use with our property.'} \

返回示例 复制代码 复制成功{ "code": "InvalidEdgeHostname", "message": "The specified edge hostname does not exist or the caller doesn't have access to this resource." }

{
    "code": "InvalidEdgeHostname",
    "message": "The specified edge hostname does not exist or the caller doesn't have access to this resource."
}

409

请求示例 复制代码 复制成功#!/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/cdn/edgeHostnames/{edgeHostname}" \ -X "PATCH" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d {'description': 'This is a new edge hostname for use with our property.'} \

#!/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/cdn/edgeHostnames/{edgeHostname}" \
-X "PATCH" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d {'description': 'This is a new edge hostname for use with our property.'} \

返回示例 复制代码 复制成功{ "code": "EdgeHostnameChangeForbidden", "message": "The edge hostname cannot be changed." }

{
    "code": "EdgeHostnameChangeForbidden",
    "message": "The edge hostname cannot be changed."
}

本篇文档内容对您是否有帮助？

有帮助

我要反馈

修改调度域名的配置（增量配置修改）

适用产品

接口描述

请求参数

Path 参数

Body 参数

错误码

示例

目录

热门产品与方案

快速入口

支持与服务

投资者关系

法律申明

关于网宿

联系我们

业务咨询