修改规则引擎规则

最近更新时间：2024-04-12 01:24:30

我的收藏

本页目录：

1. 接口描述

接口请求域名： teo.tencentcloudapi.com 。

修改规则引擎规则。

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：ModifyRule。
Version	是	String	公共参数，本接口取值：2022-09-01。
Region	是	String	公共参数，详见产品支持的地域列表。
ZoneId	是	String	站点 ID。
RuleName	是	String	规则名称，字符串名称长度 1~255。
Rules.N	是	Array of Rule	规则内容。
RuleId	是	String	规则 ID。
Status	是	String	规则状态，取值有： enable: 启用； disable: 未启用。
Tags.N	否	Array of String	规则标签。

3. 输出参数

参数名称	类型	描述
RuleId	String	规则 ID。
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 ModifyRule

常用修改

输入示例

POST / HTTP/1.1
Host: teo.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyRule
<公共请求参数>

{
    "Status": "disable",
    "Rules": [
        {
            "Actions": [
                {
                    "NormalAction": {
                        "Action": "RangeOriginPull",
                        "Parameters": [
                            {
                                "Name": "Switch",
                                "Values": [
                                    "on"
                                ]
                            }
                        ]
                    }
                },
                {
                    "CodeAction": {
                        "Action": "StatusCodeCache",
                        "Parameters": [
                            {
                                "Name": "CacheTime",
                                "StatusCode": 200,
                                "Values": [
                                    "20"
                                ]
                            }
                        ]
                    }
                },
                {
                    "RewriteAction": {
                        "Action": "ResponseHeader",
                        "Parameters": [
                            {
                                "Action": "set",
                                "Name": "Foo",
                                "Values": [
                                    "Bar"
                                ]
                            },
                            {
                                "Action": "add",
                                "Name": "Hello",
                                "Values": [
                                    "World"
                                ]
                            },
                            {
                                "Action": "del",
                                "Name": "Foo2",
                                "Values": [
                                    ""
                                ]
                            }
                        ]
                    }
                }
            ],
            "Conditions": [
                {
                    "Conditions": [
                        {
                            "Operator": "equal",
                            "Target": "host",
                            "Values": [
                                "www.shawndai.cn"
                            ]
                        }
                    ]
                }
            ]
        }
    ],
    "RuleName": "new_rule02",
    "ZoneId": "zone-26r78x31ny86",
    "RuleId": "rule-djuqmq"
}

输出示例

{
    "Response": {
        "RequestId": "811d2583-310c-41f4-b5e7-abe4074047d4",
        "RuleId": "rule-djuqmq"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

Tencent Cloud SDK 3.0 for Python: GitHub Gitee
Tencent Cloud SDK 3.0 for Java: GitHub Gitee
Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
Tencent Cloud SDK 3.0 for Go: GitHub Gitee
Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
Tencent Cloud SDK 3.0 for C++: GitHub Gitee
Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InternalError.ConfigLocked	配置已被锁定，请解除配置锁定之后在重试。
InternalError.SystemError	内部错误-系统错误。
InvalidParameter.CacheKeyQueryStringTooManyValue	查询字符串规则超过了限制。
InvalidParameter.CertSystemError	内部错误。
InvalidParameter.CompressionInvalidAlgorithms	无效的压缩算法。
InvalidParameter.ErrActionUnsupportTarget	操作不支持条件。
InvalidParameter.ErrInvalidAction	非法操作。
InvalidParameter.ErrInvalidActionDuplicateAction	非法操作-操作配置重复。
InvalidParameter.ErrInvalidActionParam	非法操作-非法参数。
InvalidParameter.ErrInvalidActionParamAction	非法操作-非法参数-无效action。
InvalidParameter.ErrInvalidActionParamDuplicateName	非法操作-非法参数-参数名重复。
InvalidParameter.ErrInvalidActionParamName	非法操作-非法参数-无效参数值类型。
InvalidParameter.ErrInvalidActionParamTooManyValues	非法操作-非法参数-参数值数量超出限制。
InvalidParameter.ErrInvalidActionParamValue	非法操作-非法参数-无效参数值。
InvalidParameter.ErrInvalidActionType	非法操作-非法类型。
InvalidParameter.ErrInvalidConditionHostTooManyWhenModifyOriginActionConfigured	修改源站操作仅支持配置一个host匹配类型。
InvalidParameter.ErrInvalidConditionIgnoreCase	非法条件-非法忽略大小写。
InvalidParameter.ErrInvalidConditionNameBadName	非法条件-非法参数名称-无效的参数名称。
InvalidParameter.ErrInvalidConditionNameTargetNotSupportName	非法条件-非法参数名称-匹配类型不支持参数名称。
InvalidParameter.ErrInvalidConditionValueBadRegular	非法条件-非法参数值-无效的正则表达式。
InvalidParameter.ErrInvalidConditionValueBadUrl	非法条件-非法参数值-无效的url。
InvalidParameter.ErrInvalidConditionValueBadValue	非法条件-非法参数值-无效的参数值。
InvalidParameter.ErrInvalidConditionValueBadValueContainFileNameExtension	非法条件-非法参数值-无效的参数值-文件名不应包含文件后缀。
InvalidParameter.ErrInvalidConditionValueTooLongValue	非法条件-非法参数值-参数值长度超出限制。
InvalidParameter.ErrInvalidConditionValueTooManyValues	非法条件-非法参数值-参数值数量超出限制。
InvalidParameter.ErrInvalidConditionValueTooManyWildcard	非法条件-非法参数值-通配符数量超出限制。
InvalidParameter.ErrInvalidElseWhenModifyOriginActionConfigured	修改源站操作不支持ELSE。
InvalidParameter.ErrNilCondition	条件为空。
InvalidParameter.GrpcRequireHttp2	开启 Grpc 协议支持需要同时开启 HTTP/2 协议支持。
InvalidParameter.HostNotFound	域名不存在。
InvalidParameter.InvalidAuthenticationTypeSecretKey	无效的token鉴权密钥。
InvalidParameter.InvalidAuthenticationTypeSignParam	无效的token鉴权参数。
InvalidParameter.InvalidAuthenticationTypeTimeFormat	无效的token鉴权时间格式。
InvalidParameter.InvalidAuthenticationTypeTimeParam	无效的token鉴权时间参数。
InvalidParameter.InvalidAwsRegion	请正确填写地域作为第三方对象存储私有访问参数。
InvalidParameter.InvalidBackupServerName	无效的备源回源Host。
InvalidParameter.InvalidCacheKey	无效的缓存键。
InvalidParameter.InvalidCacheKeyCookie	无效的自定义Cache Key Cookie无效。
InvalidParameter.InvalidCacheKeyIgnoreCase	无效的缓存键忽略大小写。
InvalidParameter.InvalidCacheKeyScheme	无效的自定义Cache Key Scheme无效。
InvalidParameter.InvalidCacheTime	无效的节点缓存时间。
InvalidParameter.InvalidClientIpHeaderName	无效的客户端IP请求头。
InvalidParameter.InvalidCosDomain	无效的回源配置，源站类型为对象存储时，源站地址必须为对象存储域名。
InvalidParameter.InvalidErrorPageRedirectUrl	无效的自定义错误页面。
InvalidParameter.InvalidHttpsCipherSuiteAndTlsVersion	加密套件与TLS版本不匹配。
InvalidParameter.InvalidHttpsHstsMaxAge	无效的HTTPS HSTS。
InvalidParameter.InvalidIpv6Switch	无效的Ipv6开关配置。
InvalidParameter.InvalidMaxAgeTime	无效的浏览器缓存。
InvalidParameter.InvalidOrigin	无效的源站。
InvalidParameter.InvalidParameter	参数错误。
InvalidParameter.InvalidRangeOriginPull	无效的分片回源。
InvalidParameter.InvalidRequestHeaderName	无效的请求头header。
InvalidParameter.InvalidRequestHeaderNameXff	x-forwarded-for 请求头配置无效
InvalidParameter.InvalidRequestHeaderValue	无效的请求头header。
InvalidParameter.InvalidResponseHeaderName	无效的响应头header。
InvalidParameter.InvalidResponseHeaderValue	无效的响应头header。
InvalidParameter.InvalidRuleEngineAction	无效的规则引擎操作。
InvalidParameter.InvalidRuleEngineNotFound	规则不存在。
InvalidParameter.InvalidRuleEngineTarget	无效的规则引擎条件。
InvalidParameter.InvalidRuleEngineTargetsExtension	无效的规则引擎文件后缀条件。
InvalidParameter.InvalidRuleEngineTargetsUrl	无效的规则引擎URL条件。
InvalidParameter.InvalidServerName	无效的回源Host。
InvalidParameter.InvalidUpstreamRequestQueryStringValue	无效的回源请求参数设置-无效查询字符串值。
InvalidParameter.InvalidUrlRedirectHost	URL重写的目标HOST无效。
InvalidParameter.InvalidUrlRedirectUrl	URL重写的目标URL无效。
InvalidParameter.KeyRulesInvalidQueryStringValue	无效的缓存键。
InvalidParameter.LoadBalanceInstanceIdIsRequired	修改源站操作中负载均衡实例Id必填。
InvalidParameter.NotSupportThisPreset	操作配置存在不支持的预设变量。
InvalidParameter.OriginOriginGroupIdIsRequired	修改源站操作中源站组Id必填。
InvalidParameter.OriginPullProtocolIsRequired	修改源站操作中回源协议必填。
InvalidParameter.PostMaxSizeLimitExceeded	最大上传大小超出限制
InvalidParameter.ResponseHeaderCacheControlNotAllowDelete	无效的响应头header。
InvalidParameter.StatusCodeCacheInvalidStatusCode	状态码缓存的状态码无效。
InvalidParameter.TlsVersionNotInSequence	HTTPS的TLS版本不连续。
LimitExceeded	超过配额限制。
OperationDenied	操作被拒绝。
OperationDenied.ConfigLocked	配置已被锁定，请解除配置锁定之后在重试。
OperationDenied.ErrZoneIsAlreadyPaused	站点处于停用状态，请开启后重试。
OperationDenied.InvalidAdvancedDefenseSecurityType	开启高防时必须保证安全是开启状态。
ResourceInUse	资源被占用。
UnauthorizedOperation.CamUnauthorized	Cam 未授权。
UnauthorizedOperation.Unknown	后端服务器发生未知错误。

上一篇: 查询站点配置下一篇: 修改站点配置