All Products
Search

This Product

    Smart Access Gateway:CreateCloudConnectNetwork

    Document Center

    Smart Access Gateway:CreateCloudConnectNetwork

    Last Updated:Mar 29, 2024

    Creates a Cloud Connect Network (CCN) instance.

    Operation description

    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.

    Authorization information

    The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

    • Operation: the value that you can use in the Action element to specify the operation on a resource.
    • Access level: the access level of each operation. The levels are read, write, and list.
    • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
      • The required resource types are displayed in bold characters.
      • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
    • Condition Key: the condition key that is defined by the cloud service.
    • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
    OperationAccess levelResource typeCondition keyAssociated operation
    smartag:CreateCloudConnectNetworkWrite
    • CloudConnectNetwork
      acs:smartag:{#regionId}:{#accountId}:ccn/*
      none
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    RegionIdstringNo

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

    		cn-shanghai
    NamestringNo

    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.

    		ccnname
    DescriptionstringNo

    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.

    		ccndesc
    CidrBlockstringNo

    The private CIDR block.

    		172.XX.XX.0/24
    SnatCidrBlockstringNo

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

    		172.XX.XX.0/25

    Response parameters

    ParameterTypeDescriptionExample
    object
    Statusstring

    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.
    		Active
    Descriptionstring

    The description about the CCN instance.

    		ccndesc
    RequestIdstring

    The ID of the request.

    		C48E8EB2-37A4-495B-A95C-29CA1FD26C82
    CcnIdstring

    The ID of the CCN instance.

    		ccn-l9340rlu5ens*****
    CidrBlockstring

    The private CIDR block.

    		172.XX.XX.0/24
    SnatCidrBlockstring

    The private CIDR block used for SNAT.

    		172.XX.XX.0/25
    Namestring

    The name of the CCN instance.

    		ccnname
    ResourceGroupIdstring

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

    		rg-acfm2iu4fnc****

    Examples

    Sample success responses

    JSONformat

    {
  "Status": "Active",
  "Description": "ccndesc",
  "RequestId": "C48E8EB2-37A4-495B-A95C-29CA1FD26C82",
  "CcnId": "ccn-l9340rlu5ens*****",
  "CidrBlock": "172.XX.XX.0/24",
  "SnatCidrBlock": "172.XX.XX.0/25",
  "Name": "ccnname",
  "ResourceGroupId": "rg-acfm2iu4fnc****"
}

    Error codes

    HTTP status codeError codeError messageDescription
    400CCN.CidrAmountLimitThe maximum number of CCN CIDR blocks is exceeded.The maximum number of CCN CIDR blocks is exceeded.
    400CCN.CidrEmptyYou must specify the CCN CIDR block.You must specify the CCN CIDR block.
    400CCN.InvalidCidrThe specified CCN CIDR block is invalid.The specified CCN CIDR block is invalid.
    400CCN.InvalidSnatCidrThe SNAT CIDR block of CCN is invalid.The SNAT CIDR block of CCN is invalid.
    400CCN.SnatCidrConflictThe specified SNAT CIDR block is invalid.The specified SNAT CIDR block is invalid.
    403InvalidDescriptionDescription not valid.The length of the description has exceeded the upper limit.
    403InvalidNameName not valid.The specified name is invalid.
    403CcnAmountLimitThe CCNs you created has reached the limit, you can raise the limit by application.The number of CCN instances that you have created has reached the upper limit. You can submit a ticket to request a quota increase.
    403ForbiddenUser not authorized to operate on the specified resource.You do not have permissions to manage the specified resource.

    For a list of error codes, visit the Service error codes.