全部产品
Search
文档中心

专有网络 VPC:DescribeEcGrantRelation - 查询跨账号创建VBR上连场景下VPC实例对VBR实例的授权关系

更新时间:Aug 28, 2026

调用DescribeEcGrantRelation接口查询跨账号创建VBR上连场景下VPC实例对VBR实例的授权关系。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

InstanceType

string

是

要查询授权关系的实例类型。取值:

  • VBR:边界路由器 VBR(Virtual border router)实例,表示查询 VBR 实例拥有哪些 VPC 实例的授权。

  • VPC:专有网络 VPC(Virtual Private Cloud)实例,表示查询 VPC 实例对哪些 VBR 实例进行了授权。

VBR

InstanceId

string

是

要查询授权关系的实例 ID。

  • 当 InstanceType 取值为 VBR 时,此处配置为 VBR 实例 ID。

  • 当 InstanceType 取值为 VPC 时,此处配置为 VPC 实例 ID。

vbr-bp12mw1f8k3jgygk9****

PageNumber

integer

否

列表的页码。默认值:1。

1

PageSize

integer

否

分页查询时每页的行数。最大值:50。默认值:10。

10

VbrRegionNo

string

否

要查询授权关系的 VBR 实例所在地域 ID。

  • 当 InstanceType 为 VBR 时,该参数需要配置。

  • 当 InstanceType 为 VPC 时,该参数不需要配置。

cn-hangzhou

返回参数

名称

类型

描述

示例值

object

请求 ID。

RequestId

string

请求 ID。

E6E90F6B-2B41-5AAF-ABEB-236ADBAAD91D

EcGrantRelations

array<object>

查询授权关系的结果列表。

object

查询授权关系的结果列表。

VbrOwnerUid

integer

VBR 实例所属的阿里云账号(主账号)ID。

1210123456123456

VbrInstanceId

string

查询的授权关系的 VBR 实例 ID。

vbr-m5ex0xf63xk8s5bob****

InstanceId

string

查询的授权关系的 VPC 实例 ID。

vpc-bp1brjuegjc88v3u9****

AliUid

integer

查询的授权关系的 VPC 所属阿里云账号(主账号)ID。

1250123456123456

RegionNo

string

查询的授权关系 VPC 所在地域 ID。

cn-hangzhou

Status

string

查询授权关系的结果。取值:

  • Created:VPC 实例与 VBR 实例已有授权关系。

  • Deleted:VPC 实例与 VBR 实例没有授权关系。

Created

InstanceName

string

查询的授权关系的 VPC 名称。

VPCname

InstanceRouterId

string

查询的授权关系的 VPC 路由器 ID。

vrt-bp1i0yzgjd8ra05ec****

VbrRegionNo

string

查询的授权关系的 VBR 实例所在地域 ID。

cn-hangzhou

GmtCreate

string

VPC 实例对 VBR 实例的授权时间。

2022-09-02T11:46Z

GrantType

string

接受授权的 VBR 实例的范围。取值:

  • All:将 VPC 实例授权给指定地域和阿里云账号(主账号)下的所有 VBR 实例。

  • Specify:将 VPC 实例授权给指定 VBR 实例。

All

TotalCount

integer

列表条目数。

10

Count

integer

查询的结果数。

1

Page

integer

列表的页码。

1

PageSize

integer

分页查询时每页的行数。

10

示例

正常返回示例

JSON格式

{
  "RequestId": "E6E90F6B-2B41-5AAF-ABEB-236ADBAAD91D",
  "EcGrantRelations": [
    {
      "VbrOwnerUid": 1210123456123456,
      "VbrInstanceId": "vbr-m5ex0xf63xk8s5bob****",
      "InstanceId": "vpc-bp1brjuegjc88v3u9****",
      "AliUid": 1250123456123456,
      "RegionNo": "cn-hangzhou",
      "Status": "Created",
      "InstanceName": "VPCname",
      "InstanceRouterId": "vrt-bp1i0yzgjd8ra05ec****",
      "VbrRegionNo": "cn-hangzhou",
      "GmtCreate": "2022-09-02T11:46Z",
      "GrantType": "All"
    }
  ],
  "TotalCount": 10,
  "Count": 1,
  "Page": 1,
  "PageSize": 10
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParam.NotNull The parameter must not be null.
400 Parameter.Illegal The parameter is illegal. 参数非法
400 Instance.StatusError The status of instance error.
400 InvalidRegionId.NotFound The regionId provided does not exist in ec region list. 提供的regionId无效,请检查。
404 VRouterId.NotFound The VRouter not found. 此VRouter实例未找到。
404 Instance.NotExist The instance not exist. 实例不存在。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。