CreateCloudConnectNetwork - API Reference| Alibaba Cloud Documentation Center

It is a device access matrix composed of Alibaba Cloud distributed access gateways. You can add multiple Smart Access Gateway (SAG) devices to a CCN instance and then attach the CCN instance to a Cloud Enterprise Network (CEN) instance to connect the local branches to the Alibaba Cloud.

Debug

Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters


Parameter	Type	Required?	Example value	Description
IsDefault	Boolean	Yes	false	Indicates whether to create a CCN instance by default. If you do not have an associated CCN instance, a CCN instance is created for you by default.
Action	String	No	CreateCloudConnectNetwork	The name of this action. Value: CreateCloudConnectNetwork
CidrBlock	String	No	172.16.22.0/24	The private CIDR block.
Description	String	No	ccn description	The description of the CCN instance. The description must be 2 to 256 characters in length. It must start with a letter and cannot start with `http://` or `https://`.
Name	String	No	ccn name	The name of the CCN instance. The name must be 2 to 128 characters in length and can contain letters, numbers, periods (.), underscores (_), and hyphens (-). The name must start with a letter. It cannot start with `http://` or `https://`.
RegionId	String	No	cn-hangzhou	The area to which the CCN instance belongs. Valid value: cn-shanghai: Mainland China
SnatCidrBlock	String	No	172.16.22.3/24	The SNAT CIDR block.

Response parameters


Parameter	Type	Example value	Description
CcnId	String	ccn-l9340rlu5ens*****	The ID of the CCN instance.
CidrBlock	String	172.16.22.0/24	The private CIDR block.
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.22.3/24	The SNAT CIDR block.
Status	String	Active	The status of the CCN instance.

Examples

Request example


https://smartag.cn-shanghai.aliyuncs.com/?Action=CreateCloudConnectNetwork
&Name=DocTest
&CommonParameters

Response examples

XML format

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

JSON format

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

Error codes


HTTP status code	Error code	Error message	Description
403	InvalidDescription	Description not valid.	The specified description is not valid.
403	InvalidName	Name not valid.	The specified name is invalid.
403	CcnAmountLimit	The CCNs you created has reached the limit, you can raise the limit by application.	The number of CCN instances you created has reached the limit. You can open a ticket to increase the quota.
403	Forbidden	User not authorized to operate on the specified resource.	You are not authorized to operate on this resource.

See common error codes.