CreateCloudConnectNetwork - API Reference| Alibaba Cloud Documentation Center

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.