Grants permissions to a Cloud Enterprise Network (CEN) instance.

Usage notes

  • Before you can attach a network instance that belongs to another Alibaba Cloud account to your CEN instance, you must grant permissions to your CEN instance.
Note GrantInstanceToCen is a Virtual Private Cloud (VPC) operation. Therefore, you must use vpc.aliyuncs.com as the domain name when you call this operation. The API version is 2016-04-28.
  • You cannot repeatedly call the GrantInstanceToCen operation to grant the permissions on a network instance to a CEN instance. The network instance can be a VPC, a virtual border router (VBR), or 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. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes GrantInstanceToCen

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

RegionId String Yes cn-hangzhou

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

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

InstanceId String Yes vpc-uf6o8d1dj8sjwxi6o****

The ID of the network instance.

InstanceType String Yes VPC

The type of the network instance. Valid values:

  • VPC: a VPC
  • VBR: a VBR
CenId String Yes cen-7qthudw0ll6jmc****

The ID of the CEN instance to which you want to grant permissions.

CenOwnerId Long Yes 123456789

The user ID (UID) of the Alibaba Cloud account to which the CEN instance belongs.

ClientToken String No 0c593ea1-3bea-11e9-b96b-88e9fe637760

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must ensure that the value is unique among all requests. The token can contain only ASCII characters.

Note If you do not specify this parameter, the system uses RequestId as ClientToken. RequestId may be different for each API request.

Response parameters

Parameter Type Example Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=GrantInstanceToCen
&RegionId=cn-hangzhou
&InstanceId=vpc-uf6o8d1dj8sjwxi6o****
&InstanceType=VPC
&CenId=cen-7qthudw0ll6jmc****
&CenOwnerId=123456789
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe637760
&Common request parameters

Sample success responses

XML format

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

<GrantInstanceToCenResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</GrantInstanceToCenResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

HttpCode Error code Error message Description
400 TaskConflict The operation is too frequent, TaskConflict. The error message returned because your requests are too frequent. Try again later.
400 Invalid.Grant Can not grant to other owner cen. The error message returned because you cannot attach the VBR to a CEN instance that belongs to another Alibaba Cloud account.

For a list of error codes, see Service error codes.