Adds an accelerated domain name.

When you associate an accelerated domain name that has an ICP number with a Global Accelerator (GA) instance, you do not need to perform further filing for the accelerated domain name or its subdomains on Alibaba Cloud.

You can call this operation to add an accelerated domain name and associate the accelerated domain name with GA instances. When you call this operation, take note of the following items:

  • If your accelerated domain name is hosted in the Chinese mainland, you must obtain an ICP number for the domain name.
  • The same accelerated domain name cannot be repeatedly associated with the same GA instance.
  • You cannot repeatedly call the CreateDomain operation by using the same Alibaba Cloud account within a specific period of time.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateDomain

The operation that you want to perform. Set the value to CreateDomain.

RegionId String No cn-hangzhou

The ID of the region where the GA instance is deployed. Set the value to cn-hangzhou.

AcceleratorIds.N String Yes ga-bp1odcab8tmno0hdq****

The ID of the GA instance.

You can enter up to 50 IDs.

Domain String Yes example.com

The accelerated domain name to be added.

Only the primary domain name can be added, such as example.com.

Response parameters

Parameter Type Example Description
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

The request ID.

Examples

Sample requests

http(s)://[Endpoint]/?Action=CreateDomain
&RegionId=cn-hangzhou
&AcceleratorIds=["ga-bp1odcab8tmno0hdq****"]
&Domain=example.com
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDomainResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</CreateDomainResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368"
}

Error codes

For a list of error codes, see Service error codes.