Domain name for API request: teo.intl.tencentcloudapi.com.
In version management mode, this API is used to create a new version of the specified configuration group.
A maximum of 20 requests can be initiated per second for this API.
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: CreateConfigGroupVersion. |
| 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 | Site ID. |
| GroupId | Yes | String | Configuration group ID for the new version. You can obtain the complete environment information through the DescribeEnvironments interface. The environment information contains the configuration group ID for each configuration group type. For reference: DescribeEnvironments return value |
| Content | Yes | String | Configuration content to be imported. Use JSON format and encode in UTF-8 mode. Refer to the example below and the configuration group syntax explanation for the configuration file content. |
| Description | No | String | Version description, enter a maximum length of 50 characters, can be used to fill in the usage scenario of this version. |
| SourceVersion | No | String | Source version ID on which the new version is based. The new version will be created as a derivative based on the configuration of this source version. This field is optional. If not provided, it defaults to the version currently taking effect in the production environment as the source version. For reference:
|
| Parameter Name | Type | Description |
|---|---|---|
| VersionId | String | Version ID. |
| 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. |
Create a new version originating from version number ver-5ksglmhghsu3 for the configuration group with ID cg-2p9unsmt54uw under site zone-m2kplohsdc4b.
POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateConfigGroupVersion
<Common request parameters>
{
"ZoneId": "zone-m2kplohsdc4b",
"GroupId": "cg-2p9unsmt54uw",
"SourceVersion": "ver-5ksglmhghsu3",
"Description": "created for openday",
"Content": "{\n \"FormatVersion\": \"1.0\",\n \"ZoneConfig\": {\n \"SmartRouting\": {\n \"Switch\": \"off\"\n },\n \"Cache\": {\n \"CustomTime\": {\n \"Switch\": \"on\",\n \"CacheTime\": 604800\n }\n },\n \"MaxAge\": {\n \"FollowOrigin\": \"on\",\n \"CacheTime\": 600\n },\n \"CacheKey\": {\n \"FullURLCache\": \"off\",\n \"QueryString\": {\n \"Switch\": \"on\",\n \"Action\": \"includeCustom\",\n \"Values\": [\n \"key1\",\n \"key2\"\n ]\n },\n \"IgnoreCase\": \"on\"\n },\n \"CachePrefresh\": {\n \"Switch\": \"off\",\n \"CacheTimePercent\": 90\n },\n \"OfflineCache\": {\n \"Switch\": \"on\"\n },\n \"Compression\": {\n \"Switch\": \"on\",\n \"Algorithms\": [\n \"brotli\",\n \"gzip\"\n ]\n },\n \"ImageOptimize\": {\n \"Switch\": \"off\"\n },\n \"ForceRedirectHTTPS\": {\n \"Switch\": \"on\",\n \"RedirectStatusCode\": 302\n },\n \"HSTS\": {\n \"Switch\": \"on\",\n \"IncludeSubDomains\": \"on\",\n \"Timeout\": 16070400,\n \"Preload\": \"on\"\n },\n \"TLSConfig\": {\n \"CipherSuite\": \"loose-v2023\",\n \"Version\": [\n \"TLSv1\",\n \"TLSv1.1\",\n \"TLSv1.2\",\n \"TLSv1.3\"\n ]\n },\n \"OCSPStapling\": {\n \"Switch\": \"off\"\n },\n \"HTTP2\": {\n \"Switch\": \"on\"\n },\n \"QUIC\": {\n \"Switch\": \"off\"\n },\n \"UpstreamHTTP2\": {\n \"Switch\": \"off\"\n },\n \"IPv6\": {\n \"Switch\": \"off\"\n },\n \"WebSocket\": {\n \"Switch\": \"on\",\n \"Timeout\": 30\n },\n \"PostMaxSize\": {\n \"Switch\": \"on\",\n \"MaxSize\": 838860800\n },\n \"ClientIPHeader\": {\n \"Switch\": \"off\",\n \"HeaderName\": \"\"\n },\n \"ClientIPCountry\": {\n \"Switch\": \"on\",\n \"HeaderName\": \"EO-Client-IPCountry\"\n },\n \"gRPC\": {\n \"Switch\": \"off\"\n },\n \"AccelerateMainland\": {\n \"Switch\": \"off\"\n },\n \"StandardDebug\": {\n \"Switch\": \"on\",\n \"AllowClientIPList\": [\n \"1.2.3.4\"\n ],\n \"Expires\": \"2023-11-04T04:46:28Z\"\n }\n },\n \"Rules\": [\n {\n \"RuleName\": \"Unnamed Rule\",\n \"Branches\": [\n {\n \"Condition\": \"${http.request.host} matches '.*'\",\"Actions\": [\n {\n \"Name\": \"UpstreamURLRewrite\",\n \"Parameters\": {\n \"Type\": \"Path\",\n \"Action\": \"rmvPrefix\",\n \"Value\": \"/prefix\"\n }\n }\n ],\n \"SubRules\": [\n {\n \"Branches\": [\n {\n \"Condition\": \"${http.request.file_extension} in ['.jpg']\",\n \"Actions\": [\n {\n \"Name\": \"PostMaxSize\",\n \"Parameters\": {\n \"Switch\": \"on\",\n \"MaxSize\": 524288000\n }\n }\n ]\n }\n ]\n },\n {\n \"Branches\": [\n {\n \"Condition\": \"${http.request.file_extension} in ['.png']\",\n \"Actions\": [\n {\n \"Name\": \"PostMaxSize\",\n \"Parameters\": {\n \"Switch\": \"on\",\n \"MaxSize\": 209715200\n }\n }\n ]\n }\n ]\n }\n ]\n }\n ]\n }\n ]\n}"
}{
"Response": {
"VersionId": "ver-5ksglmhghsuu",
"RequestId": "5e0a2b4e-dw6d-4dsa-ac39-1706cbf8a703"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
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.ConfigConditionSyntaxError | Syntax error in the condition expression of the configuration file. |
| FailedOperation.ConfigConditionUnknownTarget | Unrecognized condition matching type. |
| FailedOperation.ConfigConditionValueEmptyError | The value field of the condition expression cannot be empty in the configuration file. |
| FailedOperation.ConfigDuplicateKeyError | The keyword in the configuration file cannot be duplicated. |
| FailedOperation.ConfigFieldTypeError | The configuration file contains fields with inconsistent data types. |
| FailedOperation.ConfigFormatError | Syntax error in the configuration file. |
| FailedOperation.ConfigJSONFormatError | Version management configuration file JSON format error. |
| FailedOperation.ConfigMalformedContent | Incorrect format of the configuration file. Parsing failed. |
| FailedOperation.ConfigParamValidateErrors | Parameter verification error in the configuration file. |
| FailedOperation.ConfigTimeParsingError | Time format parsing error. |
| FailedOperation.ConfigUnknownField | The specified field in the configuration file is not recognized, indicating a possible spelling error or incorrect placement within the file structure. |
| FailedOperation.ConfigUnsupportedAction | Unsupported configuration item Action. |
| FailedOperation.ConfigUnsupportedFormatVersion | The current configuration file version is not supported. |
| FailedOperation.MissingConfigChunk | The content is missing a mandatory configuration block. |
| FailedOperation.UnknownConfigGroupType | Unknown configuration group type. |
| InvalidParameter | Parameter error. |
| InvalidParameter.DuplicateRule | Duplicate rules. |
| InvalidParameter.ErrInvalidConditionValueBadValue | Invalid condition: The parameter value is invalid. |
| InvalidParameter.InvalidCacheKeyQueryStringAction | Invalid query string. |
| InvalidParameter.InvalidConditions | Invalid conditions. |
| InvalidParameter.InvalidDynamicRoutine | Invalid smart acceleration. |
| InvalidParameter.InvalidIpv6Switch | Invalid IPv6 settings. |
| InvalidParameter.InvalidMaxAgeFollowOrigin | Invalid browser cache. |
| InvalidParameter.InvalidStandardDebug | Invalid debug configuration for EdgeOne. |
| InvalidParameter.PostMaxSizeLimitExceeded | Maximum upload size exceeded. |
| InvalidParameter.StatusCodeCacheInvalidStatusCode | Invalid status code in cache. |
| InvalidParameterValue | Invalid parameter value. |
| LimitExceeded.RuleLimitExceeded | The number of rules has reached the limit. |
| MissingParameter | Missing parameters. |
| OperationDenied | Operation denied. |
| OperationDenied.AccelerateMainlandIpv6Conflict | Cross-MLC-border acceleration and IPv6 cannot be configured at the same time. |
| OperationDenied.ConfigLocked | The configuration is locked. Please unlock and try again. |
| OperationDenied.ErrZoneIsAlreadyPaused | The EdgeOne service of the site is disabled. Please enable it and try again. |
| OperationDenied.NotInVersionControlWhiteList | The current user is not included in the whitelist for version management. |
| OperationDenied.OwnershipVerificationNotPassed | Ownership verification failed. Please complete the site ownership verification first. |
| OperationDenied.VersionControlLocked | The operation is not allowed because the version management mode is applied. |
| OperationDenied.WorkModeNotInVersionControl | The specified site working mode is not applicable to the version management mode. |
| ResourceNotFound | The resource doesn’t exist. |
| ResourceUnavailable.FunctionNotFound | The function does not exist or does not belong to this account. |
Apakah halaman ini membantu?
Anda juga dapat Menghubungi Penjualan atau Mengirimkan Tiket untuk meminta bantuan.
masukan