调用SetLiveDomainStagingConfig设置或修改灰度环境下的域名配置。

使用说明

先获取加速域名,再调用本接口设置或修改灰度环境下的域名配置。详情请参见下文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"
    }
}

错误码

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