Queries the permissions granted to attach a network instance to a Cloud Enterprise Network (CEN) instance that belongs to another Alibaba Cloud account. The network instance can be a virtual private cloud (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 DescribeGrantRulesToCen

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

RegionId String Yes cn-hangzhou

The region ID of the network instance that you want to query.

InstanceId String Yes vpc-bp18sth14qii3pnvc****

The ID of the network instance that you want to query.

InstanceType String Yes VPC

The type of the network instance. Valid values:

  • VPC
  • VBR
  • CCN
ResourceGroupId String No rg-acfmxazb4p****

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

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

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 make sure that it is unique among all requests. ClientToken can contain only ASCII characters.

Note If you do not specify this parameter, ClientToken is set to the value of RequestId. The value of RequestId for each API request may be different.
PageNumber Integer No 1

The number of the page to return. Default value: 1.

PageSize Integer No 10

The number of entries to return on each page. Maximum value: 50. Default value: 10.

Response parameters

Parameter Type Example Description
PageSize Integer 10

The number of entries returned per page.

RequestId String F5BB78C8-5F41-464F-B9FF-5E0A7198BA26

The ID of the request.

PageNumber Integer 1

The page number of the returned page.

TotalCount Integer 1

The total number of entries returned.

CenGrantRules Array of CbnGrantRule

The information about the authorization.

CbnGrantRule
CenInstanceId String cen-9gsm1q2yh1prpt****

The ID of the authorized CEN instance.

CenOwnerId Long 132193271328****

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

CreationTime String 2019-11-15T09:26:36Z

The time when the instance was created.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeGrantRulesToCen
&RegionId=cn-hangzhou
&InstanceId=vpc-bp18sth14qii3pnvc****
&InstanceType=VPC
&ResourceGroupId=rg-acfmxazb4p****	
&ClientToken=123e4567-e89b-12d3-a456-426655440000	
&PageNumber=1
&PageSize=10
&Common request parameters

Sample success responses

XML format

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

<DescribeGrantRulesToCenResponse>
    <PageSize>10</PageSize>
    <RequestId>F5BB78C8-5F41-464F-B9FF-5E0A7198BA26</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <CenGrantRules>
        <CenInstanceId>cen-9gsm1q2yh1prpt****</CenInstanceId>
        <CreationTime>2019-11-15T09:26:36Z</CreationTime>
    </CenGrantRules>
</DescribeGrantRulesToCenResponse>

JSON format

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

{
  "PageSize" : 10,
  "RequestId" : "F5BB78C8-5F41-464F-B9FF-5E0A7198BA26",
  "PageNumber" : 1,
  "TotalCount" : 1,
  "CenGrantRules" : [ {
    "CenInstanceId" : "cen-9gsm1q2yh1prpt****",
    "CreationTime" : "2019-11-15T09:26:36Z"
  } ]
}

Error codes

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