设置或修改灰度环境下的域名配置 -

使用说明

先获取加速域名，再调用本接口设置或修改灰度环境下的域名配置。详情请参见下文Functions格式说明。

QPS限制

本接口的单用户QPS限制为30次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	SetLiveDomainStagingConfig	系统规定参数。取值：SetLiveDomainStagingConfig。
DomainName	String	是	developer.aliyundoc.com	加速域名。
Functions	String	是	[{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"xxx"}],"functionName":"edge_function"}]	功能列表，仅在修改时需要指定ConfigId，详情请参见Functions格式说明。
RegionId	String	否	cn-shanghai	地域ID。

Functions格式说明

设置配置，示例如下所示：[{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"xxx"}],"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：规则执行位置。 brk：命中本条规则后，当前执行位置剩余规则均跳过。 option：option管控。 grammar：grammar管控，取值：空、es2或js。 jsmode：js域名白单管控，取值：redirect或bypass。

返回数据


名称	类型	示例值	描述
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE73368	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=SetLiveDomainStagingConfig
&DomainName=developer.aliyundoc.com
&Functions=[{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"xxx"}],"functionName":"edge_function"}]
&<公共请求参数>

正常返回示例

XML格式

<SetLiveDomainStagingConfigResponse>
  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</SetLiveDomainStagingConfigResponse>

JSON格式

{
    "SetLiveDomainStagingConfigResponse": {
        "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
    }
}

错误码

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