Authorizes a Cloud Enterprise Network (CEN) instance to communicate with a Cloud Connect Network (CCN) instance that belongs to another Alibaba Cloud account.

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 Yes GrantInstanceToCbn

The operation that you want to perform. Set the value to GrantInstanceToCbn.

CenUid Long Yes 1250123456123456

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

CcnInstanceId String Yes ccn-n2935s1mnwv8i*****

The ID of the CCN instance.

CenInstanceId String Yes cen-7qthudw0ll6jm*****

The ID of the CEN instance.

RegionId String Yes cn-shanghai

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

You can call the DescribeRegions operation to query the most recent region list.

GrantTrafficService Boolean No true

Specifies whether to grant the CEN instance permissions to manage network traffic from the CCN instance. Valid values:

  • true: grants permissions.
  • false: does not grant permissions. This is the default value.
Note If you set the value to true and the SAG instance connected to the CCN instance has the secure rerouting feature enabled, you cannot revoke the permissions.

Response parameters

Parameter Type Example Description
RequestId String 22840034-ADE9-41D8-A5DC-A7CF435CEE75

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=GrantInstanceToCbn
&CenUid=1250123456123456
&CcnInstanceId=ccn-n2935s1mnwv8i*****
&CenInstanceId=cen-7qthudw0ll6jm*****
&RegionId=cn-shanghai
&GrantTrafficService=true
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<GrantInstanceToCbnResponse>
<RequestId>22840034-ADE9-41D8-A5DC-A7CF435CEE75</RequestId>
</GrantInstanceToCbnResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "22840034-ADE9-41D8-A5DC-A7CF435CEE75"
}

Error codes

HttpCode Error code Error message Description
400 DuplicatedGrantRule The specified privilege granting rule already exists. The error message returned because the specified authorization rule already exists.

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