All Products
Search
Document Center

:DescribeVpcGrantRulesToEcr

Last Updated:May 13, 2026

Queries the cross-account authorizations between a network instance and an Express Connect Router.

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

MaxResults

integer

No

The number of entries to return per page. Valid values: 1 to 100. Default value: 100.

50

NextToken

string

No

The token used to retrieve the next page of results. Valid values:

  • Omit this parameter for the first request.

  • For subsequent requests, set this to the NextToken value from the previous response.

FFmyTO70tTpLG6I3FmYAXGKPd****

InstanceId

string

No

The ID of the network instance.

vpc-wz9ek66wd7tl5xqpy****

EcrInstanceId

string

No

The ID of the Express Connect Router.

ecr-ncxadcujadncsa****

EcrOwnerId

integer

No

The ID of the Alibaba Cloud account (main account) that owns the Express Connect Router.

Note

This parameter is required when querying a cross-account network instance.

192732132151****

RegionId

string

Yes

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

cn-hangzhou

ResourceGroupId

string

No

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

rg-acfmxazb4ph6aiy****

Tags

array<object>

No

The tags. You can specify up to 20 tags.

object

No

The tag.

Key

string

No

The tag key. The tag key cannot be an empty string.

The tag key can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.

FinanceDept

Value

string

No

The tag value. The tag value can be an empty string.

The tag value can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.

FinanceJoshua

InstanceType

string

No

The type of instance whose authorization rules you want to query. Valid values:

  • VBR: Set the value to VBR to query the Virtual Private Cloud (VPC) instances authorized to connect to the specified virtual border router (VBR).

  • VPC: Set the value to VPC to query the VBRs to which the specified VPC has granted authorization.

VPC

Response elements

Element

Type

Description

Example

object

NextToken

string

The pagination token for the next page of results. A non-empty value indicates that more results are available. If this parameter is not returned or is empty, all results have been retrieved.

  • If NextToken is empty, there are no more queries.

  • If NextToken has a value, the value is the token to start the next query.

FFmyTO70tTpLG6I3FmYAXGKPd****

RequestId

string

The ID of the request.

66342E8E-5E87-5FF9-80C7-C3E3571A****

TotalCount

string

The total number of entries. Note: When you perform a paged query by using the MaxResults and NextToken parameters, the value of this parameter is for reference only.

10

GrantRuleModels

array<object>

A list of authorization rules.

object

Details of an authorization rule.

InstanceId

string

The ID of the network instance.

vpc-wz9ek66wd7tl5xqpy****

Type

string

The type of the network instance. Valid values:

  • VBR: virtual border router

  • VPC: Virtual Private Cloud

VPC

InstanceUid

integer

The ID of the Alibaba Cloud account (main account) that owns the network instance.

192745367151****

RegionNo

string

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

cn-hangzhou

EcrId

string

The ID of the Express Connect Router.

ecr-tz7w3chlaptxr2****

EcrOwnerId

integer

The ID of the Alibaba Cloud account (main account) that owns the Express Connect Router.

192732132151****

CreationTime

string

The time when the authorization was created.

2024-09-09T02:14:51Z

Examples

Success response

JSON format

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "66342E8E-5E87-5FF9-80C7-C3E3571A****",
  "TotalCount": "10",
  "GrantRuleModels": [
    {
      "InstanceId": "vpc-wz9ek66wd7tl5xqpy****",
      "Type": "VPC",
      "InstanceUid": 0,
      "RegionNo": "cn-hangzhou",
      "EcrId": "ecr-tz7w3chlaptxr2****",
      "EcrOwnerId": 0,
      "CreationTime": "2024-09-09T02:14:51Z"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.