调用SetDcdnDomainStagingConfig设置或修改域名配置(灰度)。
接口说明
单用户调用频率:30 次/秒。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
dcdn:SetDcdnDomainStagingConfig |
update |
*domain
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
DomainName |
string |
是 |
加速域名,多个域名用英文逗号(,)分隔。 |
example.com |
Functions |
string |
是 |
功能列表,格式如下:
parentId 为 -1:表示删除该配置里面已有的规则条件。
"functionName": "功能名称", "parentId": 选填项,对应引用规则条件的 configid }] 不使用 parentId 的情况下,配置示例如下: 使用函数 origin_request_header 添加回源 HTTP 请求头的时候引用了 configid=222728944812032 的规则条件,请求参数如下:
使用 parentId 的情况下,配置示例如下: 使用函数 origin_request_header 添加回源 HTTP 请求头的时候引用了 configid=222728944812032 的规则条件,请求参数如下:
对一个已经使用了 parentId 的功能配置删除对 parentId 的引用,配置示例如下: 函数 origin_request_header 添加回源 HTTP 请求头的时候已经引用了 configid=222728944812032 的规则条件,现在要删掉对规则条件的引用,请求参数如下:
|
[{"functionArgs": [{"argName": "key","argValue": "Content-Encoding"},{"argName": "value","argValue": "gzip"}],"functionName": "set_resp_header"} ] |
某些功能可以设置多条记录,例如:edge_function,当需要更新其中某条记录时,可通过该条记录的 ConfigId(Long 类型)来指定要修改的配置项。格式如下:
[{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"yyy"}],"ConfigId":123456,"functionName":"edge_function"}]
功能说明 所有参数值均按照字符串类型处理。
功能名称 | 参数 |
edge_function:边缘函数 | 必填参数: |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
RequestId |
string |
请求 ID。 |
04F0F334-1335-436C-A1D7-6C044FE73368 |
示例
正常返回示例
JSON
格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidFunctionName.ValueNotSupported | %s | %s |
400 | InvalidArgName.ValueNotSupported | %s | 不支持的参数名称 %s(%s为具体参数名) |
400 | InvalidArgValue.Malformed | %s | %s |
400 | InvalidRule.Malformed | %s | %s |
400 | ConfigurationConflicts | The staging environment has a configuration in effect. You cannot modify the production environment configuration. | 模拟环境有一个配置,不能修改生产环境的配置。 |
400 | GrayConfigExist | A canary configuration already exists under the domain. | 域名已经存在其他灰度配置。 |
400 | InvalidDomain.BelongToConfigGroup | The domain is bound to a configuration group. Modify the domain in the configuration group. | 这个域名绑定了一个配置组,需要通过修改配置组的配置来修改。 |
400 | EdgeScriptCountExceedLimit | The number of rules exceeds the default limit. | 超过默认规则数量限制,如需提升数量,请提交工单咨询 |
400 | EdgeScripOptionsHasInnerConfig | The extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket. | 扩展项存在后台配置或该配置的参数不合法,如有疑问,请提交工单咨询 |
400 | EdgeScriptGrammarNotSupport | A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket. | 存在后台定制规则或该配置的参数不合法,如有疑问,请提交工单咨询 |
400 | EdgeScriptNotSupportJs | JavaScript rules are not supported. For more information, submit a ticket. | 未开放JS规则,如有疑问,请提交工单咨询 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。