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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeEcGrantRelation

系统规定参数。取值：DescribeEcGrantRelation。
InstanceType String 是 VBR

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

  • VBR：边界路由器VBR（Virtual border router）实例，表示查询VBR实例拥有哪些VPC实例的授权。
  • VPC：专有网络VPC（Virtual Private Cloud）实例，表示查询VPC实例对哪些VBR实例进行了授权。
InstanceId String 是 vbr-bp12mw1f8k3jgygk9****

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

  • 当InstanceType取值为VBR时，此处配置为VBR实例ID。
  • 当InstanceType取值为VPC时，此处配置为VPC实例ID。
PageNumber Long 否 1

列表的页码。默认值：1。
PageSize Long 否 10

分页查询时每页的行数。最大值：50。默认值：10。
VbrRegionNo String 否 cn-hangzhou

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

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

返回数据

名称 类型 示例值 描述
RequestId String E6E90F6B-2B41-5AAF-ABEB-236ADBAAD91D

请求ID。
EcGrantRelations Array of EcGrantRelationModel

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

VBR实例所属的阿里云账号（主账号）ID。
VbrInstanceId String vbr-m5ex0xf63xk8s5bob****

查询的授权关系的VBR实例ID。
InstanceId String vpc-bp1brjuegjc88v3u9****

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

查询的授权关系的VPC所属阿里云账号（主账号）ID。
RegionNo String cn-hangzhou

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

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

  • Created：VPC实例与VBR实例已有授权关系。
  • Deleted：VPC实例与VBR实例没有授权关系。
InstanceName String VPCname

查询的授权关系的VPC名称。
InstanceRouterId String vrt-bp1i0yzgjd8ra05ec****

查询的授权关系的VPC路由器ID。
VbrRegionNo String cn-hangzhou

查询的授权关系的VBR实例所在地域ID。
GmtCreate String 2022-09-02T11:46Z

VPC实例对VBR实例的授权时间。
GrantType String All

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

  • All：将VPC实例授权给指定地域和阿里云账号（主账号）下的所有VBR实例。
  • Specify：将VPC实例授权给指定VBR实例。
TotalCount Integer 10

列表条目数。
Count Integer 1

查询的结果数。
Page Integer 1

列表的页码。
PageSize Integer 10

分页查询时每页的行数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeEcGrantRelation
&InstanceType=VBR
&InstanceId=vbr-bp12mw1f8k3jgygk9****
&PageNumber=1
&PageSize=10
&VbrRegionNo=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParam.NotNull The parameter must not be null. 参数不能为空。
400 Parameter.Illegal The parameter is illegal. 参数非法
404 VRouterId.NotFound The VRouter not found. 此VRouter实例未找到。
404 Instance.NotExist The instance not exist. 实例不存在。

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