Creates a Cloud Connect Network (CCN) instance.

Background information

CCN is a matrix consisting of Alibaba Cloud distributed access gateways. It is an important component of Smart Access Gateway (SAG). After you associate an SAG instance with a CCN instance, the SAG instance connects the private networks associated with Alibaba Cloud. For more information, see Overview of Cloud Connect Network.

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
RegionId String No cn-shanghai

The ID of the region where the CCN instance is deployed.

Name String No ccnname

The name of the CCN instance.

The name must be 2 to 100 characters in length and can contain letters, digits, periods (.), underscores (_),and hyphens (-). The name must start with a letter.

Description String No ccndesc

The description of the CCN instance.

The description must be 2 to 128 characters in length and can contain letters, digits, underscores (_), and hyphens (-). The description must start with a letter.

Action String Yes CreateCloudConnectNetwork

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

CidrBlock String No 172.XX.XX.0/24

The private CIDR block.

SnatCidrBlock String No 172.XX.XX.0/25

The private CIDR block used for Source Network Address Translation (SNAT).

Response parameters

Parameter Type Example Description
Status String Active

The status of the CCN instance. Valid values:

  • Active: indicates the CNN instance running as expected.
  • Pending: indicates the CCN instance is to be created.
Description String ccndesc

The description about the CCN instance.

RequestId String C48E8EB2-37A4-495B-A95C-29CA1FD26C82

The ID of the request.

CcnId String ccn-l9340rlu5ens*****

The ID of the CCN instance.

CidrBlock String 172.XX.XX.0/24

The private CIDR block.

SnatCidrBlock String 172.XX.XX.0/25

The private CIDR block used for SNAT.

Name String ccnname

The name of the CCN instance.

ResourceGroupId String rg-acfm2iu4fnc****

The ID of the resource group to which the CCN instance belongs.

Examples

Sample requests

http(s)://[Endpoint]/?RegionId=cn-shanghai
&Name=ccnname
&Description=ccndesc
&Action=CreateCloudConnectNetwork
&CidrBlock=172.XX.XX.0/24
&SnatCidrBlock=172.XX.XX.0/25
&Common request parameters

Sample success responses

XML format

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

<CreateCloudConnectNetworkResponse>
<Status>Active</Status>
<RequestId>C48E8EB2-37A4-495B-A95C-29CA1FD26C82</RequestId>
<ResourceGroupId>rg-acfm2iu4fnc****</ResourceGroupId>
<CcnId>ccn-tcw17az0542xcj****</CcnId>
<Name>zxtest</Name>
</CreateCloudConnectNetworkResponse>

JSON format

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

{
  "Status" : "Active",
  "RequestId" : "C48E8EB2-37A4-495B-A95C-29CA1FD26C82",
  "ResourceGroupId" : "rg-acfm2iu4fnc****",
  "CcnId" : "ccn-tcw17az0542xcj****",
  "Name" : "zxtest"
}

Error codes

HttpCode Error code Error message Description
400 CCN.CidrAmountLimit The maximum number of CCN CIDR blocks is exceeded. The error message returned because the number of CIDR blocks of the CCN instance exceeds the upper limit.
400 CCN.CidrEmpty You must specify the CCN CIDR block. The error message returned because the CIDR block of the CCN instance is not specified.
400 CCN.InvalidCidr The specified CCN CIDR block is invalid. The error message returned because the specified CIDR block of the CCN instance is invalid.
400 CCN.InvalidSnatCidr The SNAT CIDR block of CCN is invalid. The error message returned because the specified SNAT CIDR block of the CCN instance is invalid.
400 CCN.SnatCidrConflict The specified SNAT CIDR block is invalid. The error message returned because the specified SNAT CIDR block is invalid.
403 InvalidDescription Description not valid. The error message returned because the length of the description exceeds the upper limit.
403 InvalidName Name not valid. The error message returned because the name of the CCN instance is invalid.
403 CcnAmountLimit The CCNs you created has reached the limit, you can raise the limit by application. The error message returned because the number of created CCN instances have reached the upper limit. To increase the quota, submit a ticket.
403 Forbidden User not authorized to operate on the specified resource. The error message returned because you do not have the permissions to manage the specified resource.

For a list of error codes, visit the API Error Center.