All Products
Search
Document Center

Virtual Private Cloud:DescribeGrantRulesToCen

Last Updated:Aug 28, 2026

Queries the cross-account Cloud Enterprise Network (CEN) authorization information for a specified virtual private cloud (VPC), virtual border router (VBR), or Cloud Connect Network (CCN) instance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID of the network instance.

cn-hangzhou

InstanceId

string

Yes

The ID of the network instance.

vpc-bp18sth14qii3pnvc****

InstanceType

string

Yes

The type of the network instance. Valid values:

  • VPC

  • VBR

  • CCN

VPC

ResourceGroupId

string

No

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

rg-acfmxazb4p****

ClientToken

string

No

The client token that ensures the idempotence of the request.

You can use the client to generate the token value, but you must ensure 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.

123e4567-e89b-12d3-a456-426655440000

PageNumber

integer

No

The page number. Minimum value: 1. Default value: 1.

1

PageSize

integer

No

The number of entries per page. Maximum value: 50. Minimum value: 1. Default value: 10.

10

Response elements

Element

Type

Description

Example

object

PageSize

integer

The number of entries returned per page.

10

RequestId

string

The request ID.

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

PageNumber

integer

The page number.

1

TotalCount

integer

The total number of entries returned.

1

CenGrantRules

object

CbnGrantRule

array<object>

The authorization details.

object

CenInstanceId

string

The ID of the authorized CEN instance.

cen-9gsm1q2yh1prpt****

CenOwnerId

integer

The UID of the Alibaba Cloud account that owns the authorized CEN instance.

132193271328****

CreationTime

string

The time when the instance was created.

2019-11-15T09:26:36Z

Examples

Success response

JSON format

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

Error codes

HTTP status code

Error code

Error message

Description

403 Forbbiden User not authorized to operate on the specified resource. User not authorized to operate on the specified resource.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.