SetLiveDomainStagingConfig - 设置或修改灰度环境下的域名配置-阿里云帮助中心

接口说明

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

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

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

live:SetLiveDomainStagingConfig

update

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

无

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

设置配置，示例如下所示： [{"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。

正常返回示例

JSON格式

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

HTTP status code	错误码	错误信息
400	InvalidFunctionName.ValueNotSupported	%s
400	InvalidArgName.ValueNotSupported	%s
400	InvalidArgValue.Malformed	%s
400	InvalidRule.Malformed	%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.

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

更多信息，参考变更详情。