调用SetDcdnDomainStagingConfig设置或修改域名配置(灰度)。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SetDcdnDomainStagingConfig |
操作接口名,系统规定参数。取值:SetDcdnDomainStagingConfig。 |
DomainName | String | 是 | example.com |
加速域名,多个域名用英文逗号(,)分隔。 |
Functions | String | 是 | [{\"functionArgs\":[{\"argName\":\"enable\",\"argValue\":\"on\",\"argName\":\"pri\",\"argValue\":\"1\",\"argName\":\"rule\",\"argValue\":\"xxx\"}],\"functionName\":\"edge_function\"}] |
功能列表。格式如下:
[{"functionArgs":[{"argName":"该功能参数","argValue":"该功能参数对应的值"},{"argName":"xx","argValue":"xx"}],"functionName":"功能名称"}]
说明 多个参数之间用英文逗号(,)分隔。
|
某些功能可以设置多条记录,例如:edge_function,当需要更新其中某条记录时,可通过该条记录的ConfigId(Long类型)来指定要修改的配置项。格式如下:
[{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"yyy"}],"ConfigId":123456,"functionName":"edge_function"}]
功能说明
所有参数值均按照字符串类型处理。
功能名称 |
参数 |
---|---|
edge_function:边缘函数 |
必填参数: rule:DSL规则。 pri:优先级。 enable:本条规则是否生效,取值:on或off。 可选参数: name:规则名称。 pos:规则执行位置。DCDN域名仅支持head,不支持foot。 brk:命中本条规则后,当前执行位置剩余规则均跳过。 option:option管控。 grammar:grammar管控。可选值:空、es2、js。 jsmode:js域名白单管控。可选值:redirect、bypass。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 04F0F334-1335-436C-A1D7-6C044FE73368 |
请求ID。 |
示例
请求示例
http(s)://dcdn.aliyuncs.com/?Action=SetDcdnDomainStagingConfig
&DomainName=example.com
&Functions=[{\"functionArgs\":[{\"argName\":\"enable\",\"argValue\":\"on\",\"argName\":\"pri\",\"argValue\":\"1\",\"argName\":\"rule\",\"argValue\":\"xxx\"}],\"functionName\":\"edge_function\"}]
&<公共请求参数>
正常返回示例
XML
格式
<SetDcdnDomainStagingConfigResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</SetDcdnDomainStagingConfigResponse>
JSON
格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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 | InvalidDomain.BelongToConfigGroup | The domain is bound to a configuration group. Modify the domain in the configuration group. | 这个域名绑定了一个配置组,需要通过修改配置组的配置来修改。 |
访问错误中心查看更多错误码。