修改站点回源规则配置。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
esa:UpdateOriginRule | update | *Site acs:esa:{#regionId}:{#accountId}:site/{#SiteId} |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SiteId | long | 是 | 站点 ID,可通过调用 ListSites 接口获取。 | 5407498413**** |
ConfigId | long | 是 | 配置 ID。 | 35281609698**** |
RuleName | string | 否 | 规则名称。 | rule_example |
RuleEnable | string | 否 | 规则开关。取值范围:
| on |
Rule | string | 否 | 规则内容。 | (http.host eq \"video.example.com\") |
OriginHost | string | 否 | 回源请求中携带的 HOST。 | origin.example.com |
OriginScheme | string | 否 | 回源请求使用的协议。取值范围:
| http |
OriginSni | string | 否 | 回源请求中携带的 SNI。 | origin.example.com |
DnsRecord | string | 否 | 改写回源请求的 DNS 解析记录。 | test.example.com |
OriginHttpPort | string | 否 | 使用 HTTP 协议回源时访问的源站端口。 | 8080 |
OriginHttpsPort | string | 否 | 使用 HTTPS 协议回源时访问的源站端口。 | 4433 |
Range | string | 否 | 使用 range 分片方式回源下载文件。取值范围:
| on |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | CanNotSetSequence | Non-regular configuration, you cannot set Sequence parameters. | 全局配置中不允许设置Sequence参数。 |
400 | CacheReserveSiteExceedLimit | The number of binding sites of the cache reserve instance exceeds the limit. The number of binding sites of a single cache reserve instance is limited. Please see the document for the limit. | 缓存保持实例绑定的站点数量超过上限。 |
400 | CompileRuleError | Rule compilation failed, please check the rule information passed in to ensure that the rule is written according to the syntax described in the document. | 规则编译失败,请检查传入的规则配置,请参考接口文档中描述的规则配置格式。 |
400 | SiteConfigLengthExceedLimit | The overall configuration size of the site exceeds the limit, and the total size of all functional configurations of the site cannot exceed 512K. | 站点功能配置大小超出限制,总大小不能超过512K。 |
400 | ConfigConflicts | Configuration conflicts, usually when multiple configurations are configured under the same function of the same site, such as duplicate rule names between multiple configurations. | 参数唯一性校验失败,请检查重复的参数值。 |
400 | RuleRegexQuotaCheckFailed | When configuring rules, rules with regular expressions are not allowed in this plan. Please check the relevant documentation of the plan or upgrade the plan. | 当前套餐不支持配置带有正则的规则引擎,请查看套餐描述,并升级您的套餐。 |
400 | NestedRuleQuotaCheckFailed | The nesting level of rules allowed by the plan failed to be verified. Please modify the nesting level of rules or upgrade the plan. | 规则内嵌子条件数量超过套餐上限,请查看套餐描述,并升级您的套餐。 |
400 | ArgQuotaCheckFailed | The passed-in parameter value failed to verify the validity of the plan. Please check the plan document to obtain the range of parameters that can be configured for the site plan. | 当前套餐不支持配置受限参数,请检查输入的参数。 |
400 | ServiceInvokeFailed | The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details. | 调用服务失败,请稍后重试或联系客服咨询详情。 |
400 | FunctionConflict | The feature configuration conflicts. Sites with version management enabled cannot configure this feature. | 当前配置的功能与其它功能存在冲突,如需要配置请先删除冲突的功能配置。 |
400 | SpecifiedVersionReadOnly | The specified version number is read-only and cannot be modified. | 指定的版本号为只读版本, 无法修改版本配置。 |
400 | VersionNotValid | The site does not have version management enabled, or the version number passed in does not exist. | 站点没有开启版本管理功能,或者传入的版本号不存在。 |
400 | InternalException | Failed to call the service. Try again later or contact technical support. | 调用服务失败,请稍后重试或联系客服咨询详情。 |
400 | InvalidParameter.ArgName | Invalid ArgName. Check your website configuration parameters and make sure that they match the supported features and parameter names listed in the official documentation. | 传入的ArgName无效,请检查您提供的站点配置参数,确保它们与官方文档中列出的支持功能及参数名称相匹配。 |
400 | InvalidParameter.ArgValue | Invalid parameter value. Check whether the value format and length meet the requirements. | 参数值无效,请检查输入是否符合规定格式及长度限制。 |
400 | InvalidParameter.Configs | Invalid parameter configurations. Check whether your feature configurations are in the valid format and comply with relevant requirements. | 配置参数错误,请检查站点功能设置项是否遵循规定格式及要求。 |
400 | InstanceNotExist | The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account. | 实例不存在,请检查提供的实例ID是否正确或该实例是否属于您的账户。 |
400 | LockFailed | The system is handling requests you previously submitted. Try again later. | 您有其他请求正在处理中,请稍后再进行重试。 |
400 | IllegalOperation.VersionManagement | The version management operation failed because incompatible features or environment settings are configured. Adjust your configurations and try again. | 当前进行版本管理操作时,存在与其互斥的功能或环境设置,请先调整相关配置后再尝试。 |
400 | QuotaCheckFailed.VersionManagement | Insufficient quota for version management. Contact technical support. | 当前套餐的版本管理配额不足,请联系客服咨询详情。 |
400 | InvalidConfigId | The input configuration ID: ConfigId it does not exist, query the existing configuration and its valid ConfigId through the ListSiteFunction. | 传入的ConfigId不存在。 |
400 | Instance.NotOnline | Your plan is unavailable due to an overdue payment. Complete the payment first. | 您的套餐实例因欠费当前处于非上线状态,请先完成续费操作以继续使用。 |
404 | SiteNotFound | The website does not exist or does not belong to you. | 站点不存在,或者不属于你。 |
访问错误中心查看更多错误码。