调用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. 这个域名绑定了一个配置组,需要通过修改配置组的配置来修改。

访问错误中心查看更多错误码。