History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
Domain name for API request: teo.intl.tencentcloudapi.com.
This API is used to create an acceleration domain name.
For sites connected via the CNAME, if you have not verified the ownership of the domain name, the ownership verification information of the domain name is returned. To verify your ownership of the domain name, see Ownership Verification.
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: CreateAccelerationDomain. |
| 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 | ID of the site related with the acceleration domain name. |
| DomainName | Yes | String | Acceleration domain name |
| OriginInfo | Yes | OriginInfo | Details of the origin. |
| OriginProtocol | No | String | Origin-Pull protocol. valid values:. |
| HttpOriginPort | No | Integer | HTTP origin port. default value 80. value range: 1–65535. This parameter is valid only when OriginProtocol is FOLLOW or HTTP. |
| HttpsOriginPort | No | Integer | HTTPS origin port. default value 443. value range: 1–65535. This parameter is valid only when OriginProtocol is FOLLOW or HTTPS. |
| IPv6Status | No | String | IPv6 status. valid values:. |
| SharedCNAME | No | String | Specify the shared CNAME address for domain binding. use the default CNAME when not specified. Bind shared CNAME requires the scheduling policy of all domains to be consistent. the following configuration affects the scheduling policy. when inconsistent, bind shared CNAME will be processed as follows:. -IPv6 access: not allowed to create domain name. change IPv6Status to keep it configured the same as other domain names bound to the shared CNAME. -Anti-DDoS: if the selected shared CNAME has DDoS protection enabled, domain activation will enable DDoS protection by default. -Network optimization in the chinese mainland (international acceleration): not allowed to create a domain name. keep the network optimization in the chinese mainland (international acceleration) configuration of the current domain name consistent with the other domain names bound to the shared CNAME and try again after. Note: shared CNAME is currently in beta test. if you need to use it, contact us to enable it. |
| Parameter Name | Type | Description |
|---|---|---|
| OwnershipVerification | OwnershipVerification | Use the information returned by this parameter to verify the ownership of a domain name. For details, see Ownership Verification. Note: This field may return·null, indicating that no valid values can be obtained. |
| 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 an acceleration domain name and use the specified shared CNAME.
POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAccelerationDomain
<Common request parameters>
{
"ZoneId": "zone-225qgrnvbi9w",
"DomainName": "www.example.com",
"OriginInfo": {
"OriginType": "ip_domain",
"Origin": "1.1.1.1"
},
"OriginProtocol": "FOLLOW",
"HttpOriginPort": 80,
"HttpsOriginPort": 443,
"IPv6Status": "follow",
"SharedCNAME": "sharedomain.225qgrnvbi9w.share.dnse5.com"
}
{
"Response": {
"OwnershipVerification": null,
"RequestId": "3d310306-f298-439a-9daa-29eec8490769"
}
}
This example shows you how to create an acceleration domain name for an AWS S3 origin server, with private network access enabled and authentication algorithm set to AWS Signature Version 2.
POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAccelerationDomain
<Common request parameters>
{
"ZoneId": "zone-225qgrnvbi9w",
"DomainName": "qq.com",
"OriginInfo": {
"OriginType": "AWS_S3",
"Origin": "test.s3.ap-east-1.amazonaws.com",
"PrivateAccess": "on",
"PrivateParameters": [
{
"Name": "AccessKeyId",
"Value": "nMirpdWhhT6bxPsaFwYM1SzQrTest"
},
{
"Name": "SecretAccessKey",
"Value": "AKID***********************************************"
},
{
"Name": "SignatureVersion",
"Value": "v2"
},
{
"Name": "Region",
"Value": "ap-east-1"
}
]
}
}
{
"Response": {
"RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a703"
}
}
Create an acceleration domain name with the origin server type set to VOD, and specify origin retrieval for all files within the current VOD application.
POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAccelerationDomain
<Common request parameters>
{
"ZoneId": "zone-36oiczk333c3",
"DomainName": "vbt-06.bennyddeng.work",
"OriginInfo": {
"OriginType": "VOD",
"Origin": "220643",
"VodOriginScope": "all"
}
}
{
"Response": {
"OwnershipVerification": null,
"RequestId": "ec58b4d5-9154-4fd8-a148-7b39af634f2b"
}
}
Create an acceleration domain name with the origin server type as VOD, and specify origin retrieval to files in a bucket under the present VOD application.
POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAccelerationDomain
<Common request parameters>
{
"ZoneId": "zone-36oiczk333c3",
"DomainName": "vbt-05.bennyddeng.work",
"OriginInfo": {
"OriginType": "VOD",
"Origin": "220643",
"VodOriginScope": "bucket",
"VodBucketId": "9n15dnlrwu800zh"
}
}
{
"Response": {
"OwnershipVerification": null,
"RequestId": "8e26894c-e6f5-43ae-be0e-ef2377b88ea6"
}
}
This example shows you how to create an acceleration domain name for a domain-name origin server.
POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAccelerationDomain
<Common request parameters>
{
"ZoneId": "zone-225qgrnvbi9w",
"DomainName": "qq.com",
"OriginInfo": {
"OriginType": "ip_domain",
"Origin": "www.test.com"
}
}
{
"Response": {
"RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707"
}
}
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. |
| InternalError.ConfigLocked | The configuration is locked. Please unlock and try again. |
| InvalidParameter.ConflictHostOrigin | The origin cannot be the same as the domain name. |
| InvalidParameter.ErrInvalidActionParam | Invalid operation: Invalid parameter. |
| InvalidParameter.InvalidAccelerateType | Parameter error. |
| InvalidParameter.InvalidAwsPrivateAccess | Invalid third-party object storage. |
| InvalidParameter.InvalidAwsRegion | Invalid region. Please fill in a correct region of the third-party object storage service. |
| InvalidParameter.InvalidClientIpOrigin | Invalid origin for region-specific origin-pull. |
| InvalidParameter.InvalidIpv6Switch | Invalid IPv6 settings. |
| InvalidParameter.InvalidOrigin | Invalid origin server. |
| InvalidParameter.InvalidOriginIp | The origin cannot be a private IP or loopback address. |
| InvalidParameter.InvalidPrivateAccessParams | AccessKeyId and SecretAccessKey are required to access the third-party object storage. |
| InvalidParameter.InvalidPrivateAccessSwitch | The value of PrivateAccess should be on or off. |
| InvalidParameter.InvalidQuicBilling | The plan does not support QUIC. |
| InvalidParameter.InvalidServerName | Invalid origin domain. |
| InvalidParameter.InvalidStandardDebugClientIp | Invalid client IP or CIDR block. |
| InvalidParameter.InvalidWebSocketTimeout | Invalid WebSocket. |
| InvalidParameter.PostMaxSizeLimitExceeded | Maximum upload size exceeded. |
| InvalidParameter.SpaceNotBindOrigin | Shield Space is not bound with an origin. |
| InvalidParameter.ZoneIsGrayPublishing | The site is being upgraded. Changing is not supported. Please try again later. |
| InvalidParameterValue.ConflictRecord | It conflicts with existing records. |
| InvalidParameterValue.ConflictWithDNSSEC | DNS records conflict with DNSSEC. |
| InvalidParameterValue.ConflictWithDomain | The DNS record conflicts with acceleration domain name record. |
| InvalidParameterValue.ConflictWithNSRecord | This DNS record conflicts with NS records. |
| InvalidParameterValue.ContentSameAsName | The host record cannot be the same as the record value. |
| InvalidParameterValue.DomainNotMatchZone | The specified domain name does not match the site. |
| InvalidParameterValue.InvalidDNSContent | Incorrect DNS record. |
| InvalidParameterValue.InvalidDNSName | Incorrect DNS record name. |
| InvalidParameterValue.InvalidDomainName | Invalid accelerated domain name. It can contain [0-9], [A-Z], [a-z] and [-]. It cannot start or end with "-". |
| InvalidParameterValue.InvalidProxyOrigin | Incorrect DNS proxy |
| InvalidParameterValue.OriginGroupNotExists | The specified origin group does not exist. |
| OperationDenied | Operation denied. |
| OperationDenied.AccelerateMainlandDisable | Cross-MLC-border acceleration is in beta. To join the beta, submit a ticket. |
| 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.DomainNoICP | The domain name doesn't have an ICP filing number. |
| OperationDenied.ErrZoneIsAlreadyPaused | The EdgeOne service of the site is disabled. Please enable it and try again. |
| OperationDenied.InvalidAdvancedDefenseZoneArea | The acceleration regions of the site must be in the Chinese mainland when you enable the DDoS Protection. |
| OperationDenied.LoadBalanceStatusNotInOnline | The affiliated Cloud Load Balancer is not in a running state. Operation is forbidden. |
| OperationDenied.RecordIsForbidden | The DNS record cannot be added. |
| OperationDenied.ResourceLockedTemporary | This operation conflicts with concurrent operations. Try again later. |
| OperationDenied.VersionControlIsGraying | There is a test version in use. Please release the test version to the live environment, or roll back the test version and try again. |
| ResourceInUse | The resource is occupied. |
| ResourceInUse.DnsRecord | The domain name is being resolved. If you need to enable acceleration, please go to DNS Records. |
| ResourceNotFound | The resource doesn’t exist. |
| ResourceUnavailable.DomainAlreadyExists | The domain name is already connected to EdgeOne by another account. Please retrieve it first in order to add it. |
| ResourcesSoldOut.L7LackOfResources | Resources are selling fast and currently sold out. Restocking is in progress, so new domains cannot be added at the moment. Please wait patiently. |
| UnauthorizedOperation.CamUnauthorized | CAM is not authorized. |
| UnauthorizedOperation.NoPermission | The sub-account is not authorized for the operation. Please get permissions first. |
| UnauthorizedOperation.Unknown | An unknown error occurred in the backend server. |
フィードバック