You can call this operation to create a Cloud Connect Network (CCN) instance.

CCN is a device access matrix composed of Alibaba Cloud distributed access gateways. You can associate a CCN instance with a Cloud Enterprise Network (CEN) instance to connect local branches to Alibaba Cloud.

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 No CreateCloudConnectNetwork

The operation that you want to perform.

Set the value to CreateCloudConnectNetwork.

RegionId String No cn-hangzhou

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

Name String No The name of the CCN instance

The name of the CCN instance.

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

Description String No The description of the CCN instance

The description of the CCN instance.

The name must be 2 to 128 characters in length, and can contain digits, underscores (_), and hyphens (-). It must start with a letter or Chinese character.

CidrBlock String No 172.16.XX.0/24

The CIDR block of the private network.

SnatCidrBlock String No 172.16.XX.0/25

The internal CIDR block used in Source Network Address Translation (SNAT).

Response parameters

Parameter Type Example Description
CcnId String ccn-l9340rlu5ens*****

The ID of the CCN instance.

CidrBlock String 172.16.XX.0/24

the CIDR block of the private network.

Description String CCN description

The description of the CCN instance.

Name String CCN name

The name of the CCN instance.

RequestId String F0C4D78D-C60E-4A3B-A652-3A2835305C0B

The ID of the request.

SnatCidrBlock String 172.16.XX.0/25

The internal CIDR block used in SNAT.

Status String Active

The status of the CCN instance. Valid values:

  • Active: The CCN instance is running as expected.
  • Pending: The CCN instance is pending to be created.

Examples

Sample requests

http(s)://[Endpoint]/? Action=CreateCloudConnectNetwork
&<Common request parameters>

Sample success responses

XML format

<CreateCloudConnectNetworkResponse>
    <Name>DocTest</Name>
    <Status>Active</Status>
    <RequestId>F0C4D78D-C60E-4A3B-A652-3A2835305C0B</RequestId>
    <CcnId>ccn-l9340rlu5enstm****</CcnId>
</CreateCloudConnectNetworkResponse>

JSON format

{
  "Name": "DocTest",
  "Status": "Active",
  "RequestId": "F0C4D78D-C60E-4A3B-A652-3A2835305C0B",
  "CcnId": "ccn-l9340rlu5enstm****"
}

Error codes

HttpCode Error code Error message Description
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 specified name 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 exceeds the upper limit. Submit a ticket to increase the quota.
403 Forbidden User not authorized to operate on the specified resource. The error message returned because you do not have the permission to manage the resource.
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 overlaps with another one.

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