All Products
Search
Document Center

Smart Access Gateway:BindSmartAccessGateway

Last Updated:Mar 03, 2024

Associates a Smart Access Gateway (SAG) instance with a Cloud Connect Network (CCN) instance.

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:BindSmartAccessGatewayWrite
  • CloudConnectNetwork
    acs:smartag:{#regionId}:{#accountId}:ccn/{#CcnId}
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
CcnIdstringYes

The ID of the CCN instance with which you want to associate the SAG instance.

ccn-isdjvvkexkrpk*****
SmartAGIdstringYes

The ID of the SAG instance.

sag-m7ez44zpayma*****
RegionIdstringNo

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

cn-hangzhou
SmartAGUidlongNo

The ID of the Alibaba Cloud account to which the SAG instance belongs.

1250123456123456

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

8A3FF8DD-B27D-4ED2-B032-5EF90B38195D

Examples

Sample success responses

JSONformat

{
  "RequestId": "8A3FF8DD-B27D-4ED2-B032-5EF90B38195D"
}

Error codes

HTTP status codeError codeError messageDescription
400SAG.NoBindSNThe specified SAG is not bound with a serial number. Please perform binding first.The specified SAG is not bound with a serial number. Please perform binding first.
400SAG.NoBandwidthBuy bandwidth for the specified SAG instance before binding it to a CCN instance.Buy bandwidth for the specified SAG instance before binding it to a CCN instance.
400NotBoundCENBind the specified CCN instance to a CEN instance first.Bind the specified CCN instance to a CEN instance first.
400SAG.VbrNotBondCenBind the specified VBR instance to a CEN instance first.Bind the specified VBR instance to a CEN instance first.
400AlreadyBound.CCNThe specified SAG instance is bound to another CCN instance. Unbind them first.The specified SAG instance is associated with another CCN instance. Disassociate them first.
400LinkLevelBackupExistsThe specified SAG instance is already used as a leased line backup.The specified SAG instance is already used as a leased line backup.
400TunnelIdDistributeErrorTunnel id distribute error.An error occurred while distributing tunnel IDs.
400UpdateError.SMARTAGUpdate smart access gateway error.An error occurred while updating the SAG instance.
400SmartAccessGatewayInArrearsThe specified Smart Access Gateway has expired.The specified Smart Access Gateway has expired.
400SmartAccessGatewayNotActivatedThe specified Smart Access Gateway has not been activated.The specified SAG instance is inactive. You must activate the instance first.
403CidrConflictCidr is conflict, Please Check your input.-
403MissingParameterThe input parameter is missing, please check your input.Missing parameters. Check whether all required parameters are set.
403InvalidId.CCNInvalid cloud connect network id.The ID of the CCN instance is invalid.
403InvalidId.SMARTAGThe specified smart access gateway instance id is invalid.The SAG instance ID is invalid.
403SmartAccessGatewayAlreadyBoundThe smart access gateway already bound.The SAG instance has already been associated with a CCN instance.
403TunnelIdNotEnoughTunnel id is not enough.Tunnel IDs are insufficient.
403ForbiddenUser not authorized to operate on the specified resource.You do not have permissions to manage the specified resource.
403VbrConflict.ChangeSubnetThe subnet of the gateway conflicts with the VBR. Modify the subnet first.The subnet CIDR block of the SAG instance is in conflict with the VBR. You must change the subnet CIDR block.

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