tencent cloud

边缘安全加速平台 EO

动态与公告
产品动态
安全公告
产品公告
产品简介
产品概述
产品优势
应用场景
EdgeOne 与 CDN 等产品功能对比
使用限制
购买指南
试用套餐体验权益说明
免费版套餐使用说明
计费概述
计费项目
购买指引
续费指引
欠费与退款说明
套餐选型对比
关于“干净流量”计费说明
DDoS 防护容量说明
快速入门
选择业务场景
快速接入网站安全加速
通过 Pages 快速部署网站
域名服务与源站配置
域名服务
HTTPS 证书
源站配置
站点加速
概述
访问控制
智能加速
缓存配置
文件优化
网络优化
URL 重写
修改头部
修改应答内容
规则引擎
图片与视频处理
单连接下载限速
DDoS 与 Web 防护
概述
DDoS 防护
Web 防护
Bot 管理
API 资产识别(Beta)
边缘函数
概述
快速指引
操作指引
Runtime APIs
示例函数
实践教程
Pages
四层代理
概述
新建四层代理实例
修改四层代理实例配置
停用/删除四层代理实例
批量配置转发规则
获取客户端真实IP
数据分析与日志服务
日志服务
数据分析
告警服务
站点与计费管理
计费管理
站点管理
版本管理
通用策略
通用参考
配置语法
请求与响应行为
国家/地区及对应代码枚举
Terraform
Terraform 简介
安装和配置 Terraform
实践教程
自动预热/清除缓存
防盗刷/盗链实践
HTTPS 相关实践
加速优化
流量调度
数据分析与告警
第三方日志平台集成实践
对象存储类源站(例如:COS)配置实践
跨域响应配置
API 文档
History
Introduction
API Category
Making API Requests
Site APIs
Acceleration Domain Management APIs
Site Acceleration Configuration APIs
Edge Function APIs
Alias Domain APIs
Security Configuration APIs
Layer 4 Application Proxy APIs
Content Management APIs
Data Analysis APIs
Log Service APIs
Billing APIs
Certificate APIs
Origin Protection APIs
Load Balancing APIs
Diagnostic Tool APIs
Custom Response Page APIs
API Security APIs
DNS Record APIs
Content Identifier APIs
Legacy APIs
Ownership APIs
Image and Video Processing APIs
Multi-Channel Security Gateway APIs
Version Management APIs
Data Types
Error Codes
常见问题
产品特性相关问题
DNS 记录相关问题
域名配置相关问题
站点加速相关问题
数据与日志相关问题
安全防护相关问题
源站配置相关问题
排障指南
异常状态码参考
EdgeOne 4XX/5XX 状态码排障指南
520/524状态码排障指南
521/522 状态码排障指南
工具指南
相关协议
Service Level Agreement
源站防护启用特别约定
TEO 政策
隐私协议
数据处理和安全协议
联系我们
词汇表

ModifyL7AccSetting

PDF
聚焦模式
字号
最后更新时间: 2025-11-27 16:42:25

1. API Description

Domain name for API request: teo.intl.tencentcloudapi.com.

This API is used to modify the global configuration of Site Acceleration.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: ModifyL7AccSetting.
Version Yes String Common Params. The value used for this API: 2022-09-01.
Region No String Common Params. This parameter is not required.
ZoneId Yes String Zone id.
ZoneConfig Yes ZoneConfig Site acceleration global configuration. the settings in this parameter will apply to all domain names under the site. you only need to modify the required settings directly, and other settings not passed in will remain unchanged.

3. Output Parameters

Parameter Name Type Description
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Modifying the Global Configuration for Site Acceleration

This example shows you how to modify the global configuration for site acceleration.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyL7AccSetting
<Common request parameters>

{
    "ZoneId": "zone-21xfqlh4qjee",
    "ZoneConfig": {
        "SmartRouting": {
            "Switch": "on"
        },
        "Cache": {
            "CustomTime": {
                "CacheTime": 2592000,
                "Switch": "off"
            },
            "FollowOrigin": {
                "DefaultCache": "on",
                "DefaultCacheStrategy": "on",
                "DefaultCacheTime": 0,
                "Switch": "on"
            },
            "NoCache": {
                "Switch": "off"
            }
        },
        "MaxAge": {
            "FollowOrigin": "on",
            "CacheTime": 600
        },
        "CacheKey": {
            "FullURLCache": "on",
            "IgnoreCase": "off",
            "QueryString": {
                "Action": "includeCustom",
                "Switch": "off",
                "Values": []
            }
        },
        "CachePrefresh": {
            "CacheTimePercent": 90,
            "Switch": "on"
        },
        "OfflineCache": {
            "Switch": "on"
        },
        "Compression": {
            "Algorithms": [
                "brotli",
                "gzip"
            ],
            "Switch": "on"
        },
        "ForceRedirectHTTPS": {
            "RedirectStatusCode": 302,
            "Switch": "off"
        },
        "HSTS": {
            "IncludeSubDomains": "off",
            "Timeout": 0,
            "Preload": "off",
            "Switch": "off"
        },
        "TLSConfig": {
            "Version": [
                "TLSv1",
                "TLSv1.1",
                "TLSv1.2",
                "TLSv1.3"
            ],
            "CipherSuite": "loose-v2023"
        },
        "OCSPStapling": {
            "Switch": "off"
        },
        "HTTP2": {
            "Switch": "off"
        },
        "QUIC": {
            "Switch": "off"
        },
        "UpstreamHTTP2": {
            "Switch": "off"
        },
        "IPv6": {
            "Switch": "off"
        },
        "WebSocket": {
            "Switch": "off",
            "Timeout": 30
        },
        "PostMaxSize": {
            "MaxSize": 524288000,
            "Switch": "on"
        },
        "ClientIPHeader": {
            "HeaderName": "",
            "Switch": "off"
        },
        "ClientIPCountry": {
            "HeaderName": "",
            "Switch": "off"
        },
        "Grpc": {
            "Switch": "off"
        },
        "NetworkErrorLogging": {
            "Switch": "on"
        },
        "AccelerateMainland": {
            "Switch": "off"
        },
        "StandardDebug": {
            "AllowClientIPList": [],
            "Expires": "1969-12-31T16:00:00Z",
            "Switch": "off"
        }
    }
}

Output Example

{
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707"
    }
}

Example2 Modifying Site Acceleration Global IPv6 Access Configuration

This example shows you how to enable IPv6 access for all domain names under the site.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyL7AccSetting
<Common request parameters>

{
    "ZoneId": "zone-21xfqlh4qjee",
    "ZoneConfig": {
        "IPv6": {
            "Switch": "on"
        }
    }
}

Output Example

{
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707"
    }
}

Example3 Modifying Global QUIC Configuration for Site Acceleration

This example shows you how to enable QUIC for all domain names under the site.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyL7AccSetting
<Common request parameters>

{
    "ZoneId": "zone-21xfqlh4qjee",
    "ZoneConfig": {
        "QUIC": {
            "Switch": "on"
        }
    }
}

Output Example

{
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707"
    }
}

Example4 Modifying the Global Node Cache TTL Configuration for Site Acceleration

This example shows you how to configure the cache as no-cache for ALL domains under the site.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyL7AccSetting
<Common request parameters>

{
    "ZoneId": "zone-21xfqlh4qjee",
    "ZoneConfig": {
        "Cache": {
            "NoCache": {
                "Switch": "on"
            }
        }
    }
}

Output Example

{
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
FailedOperation Operation failed.
FailedOperation.CertificateNotFound The edge HTTPS certificate does not exist.
InternalError.ConfigLocked The configuration is locked. Please unlock and try again.
InternalError.RouteError The backend routing address is incorrect.
InternalError.SystemError Internal system error.
InternalError.UnknowError Unknown error.
InvalidParameter.ActionInProgress Too many attempts. Please try again later.
InvalidParameter.CacheKeyQueryStringRequiresFullUrlCacheOff Invalid query string.
InvalidParameter.CacheKeyQueryStringTooManyValue The query string has too many values.
InvalidParameter.CertSystemError Internal error.
InvalidParameter.ClientIpCountryConflictsWithIpv6 IPv6 access conflicts with client IP geographical location.
InvalidParameter.GrpcRequireHttp2 To enable gRPC support, HTTP/2 support must be enabled as well.
InvalidParameter.InvalidAwsPrivateAccess Invalid third-party object storage.
InvalidParameter.InvalidCacheConfigFollowOrigin Invalid node cache. The origin behavior is followed.
InvalidParameter.InvalidCacheKeyQueryStringValue Invalid query string.
InvalidParameter.InvalidCacheOnlyOnSwitch Invalid node cache.
InvalidParameter.InvalidCacheTime Invalid node cache validity.
InvalidParameter.InvalidClientIpCountryHeaderName Invalid client IP location configuration. HeaderName consists of 1-100 alphanumeric characters and cannot start or end with hyphens (-).
InvalidParameter.InvalidClientIpHeaderName Invalid client IP request header.
InvalidParameter.InvalidDynamicRoutine Invalid smart acceleration.
InvalidParameter.InvalidDynamicRoutineBilling The package does not support Smart Acceleration.
InvalidParameter.InvalidForceRedirectType Invalid enforced HTTPS redirect.
InvalidParameter.InvalidHttps Invalid parameter "https".
InvalidParameter.InvalidHttpsCertInfo Invalid edge HTTPS certificate configuration. The certificate content is invalid.
InvalidParameter.InvalidHttpsCipherSuiteAndTlsVersion The cipher suite does not match the TLS version.
InvalidParameter.InvalidHttpsHstsMaxAge Invalid HTTPS HSTS.
InvalidParameter.InvalidHttpsTlsVersion Invalid HTTPS TLS version.
InvalidParameter.InvalidIpv6Switch Invalid IPv6 settings.
InvalidParameter.InvalidMaxAgeTime Invalid browser cache.
InvalidParameter.InvalidOrigin Invalid origin server.
InvalidParameter.InvalidOriginType Incorrect origin server type.
InvalidParameter.InvalidParameter Invalid parameter.
InvalidParameter.InvalidPostMaxSizeBilling The speciThe plan does not support limiting the max upload size.
InvalidParameter.InvalidPostSizeValue Invalid POST request size.
InvalidParameter.InvalidRangeOriginPull Invalid Range GETs.
InvalidParameter.InvalidRequestHeaderName Invalid request header.
InvalidParameter.InvalidResourceIdBilling You have not purchased a plan yet.
InvalidParameter.InvalidStandardDebugClientIp Invalid client IP or CIDR block.
InvalidParameter.InvalidStandardDebugEmptyList The AllowClientIPList parameter is mandatory. The IPv4 and IPv6 network segments are supported. 0.0.0.0/0 indicates that all IPv4 clients can be debugged, and ::/0 indicates that all IPv6 clients can be debugged.
InvalidParameter.InvalidStandardDebugExpireTimeLimit The expiration time is exceeded.
InvalidParameter.InvalidWebSocketTimeout Invalid WebSocket.
InvalidParameter.MultiplyLayerNotSupportSmartRouting Smart routing is not supported.
InvalidParameter.OCDirectOriginRequiresSmartRouting The domain name is configured to forward requests to the origin directly. iSmart Acceleration must be enabled.
InvalidParameter.PostMaxSizeLimitExceeded Maximum upload size exceeded.
InvalidParameter.SettingInvalidParam Configuration parameter error.
InvalidParameter.ZoneIsGrayPublishing The site is being upgraded. Changing is not supported. Please try again later.
InvalidParameter.ZoneNotFound The site does not exist.
InvalidParameterValue.FormatMismatch Format mismatch.
InvalidParameterValue.GeneralMismatch Configuration parameter format mismatch.
InvalidParameterValue.IncludeInvalidValue Contains invalid value.
InvalidParameterValue.MissingNecessaryParam Missing required configuration parameters.
InvalidParameterValue.NotInEnumeration The value is not within the required collection.
InvalidParameterValue.NotWithinRange The value is not within the specified range.
InvalidParameterValue.RegExMismatch Does not match the specified regular expression.
InvalidParameterValue.UnrecognizableValue Configuration item error.
OperationDenied Operation denied.
OperationDenied.AccelerateMainlandDisable Cross-MLC-border acceleration is in beta. To join the beta, submit a ticket.
OperationDenied.AccelerateMainlandIpv6Conflict Cross-MLC-border acceleration and IPv6 cannot be configured at the same time.
OperationDenied.AccelerateMainlandMultiplyLayerConflict The existing domain feature under the current site conflicts with the Chinese mainland network optimization, and cannot be configured at the same time.
OperationDenied.ConfigLocked The configuration is locked. Please unlock and try again.
OperationDenied.DisableZoneNotCompleted The EdgeOne service of the site is being disabled. Please try again later.
OperationDenied.ErrZoneIsAlreadyPaused The EdgeOne service of the site is disabled. Please enable it and try again.
OperationDenied.SharedCNAMEUnsupportedAccelerateMainland The domain name is bound with a shared CNAME and cannot be changed to "Cross-MLC-border acceleration". Please unbind the domain name from the shared CNAME first.
OperationDenied.SharedCNAMEUnsupportedIPv6 The domain name is bound with a shared CNAME and cannot be changed to "IPv6 access". Please unbind the domain name from the shared CNAME first.
ResourceInUse The resource is occupied.
ResourceNotFound The resource doesn’t exist.
ResourceNotFound.PostMaxSizeQuotaNotFound Maximum upload size is not configured.
ResourceUnavailable.CertNotFound The certificate does not exist or is not authorized.
UnauthorizedOperation.CamUnauthorized CAM is not authorized.
UnauthorizedOperation.NoPermission The sub-account is not authorized for the operation. Please get permissions first.

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈