调用GrantInstanceToVbr接口将跨账号创建VBR上连场景的VPC实例授权给VBR实例。

使用说明

创建跨账号VBR上连时，您需要将VPC实例授权给VBR实例。

调试

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

请求参数

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

系统规定参数。取值：GrantInstanceToVbr。
RegionId String 是 cn-hangzhou

要授权的VPC实例所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。
VbrOwnerUid Long 是 1210123456123456

接受授权的VBR实例所属阿里云账号（主账号）ID。
VbrInstanceIds Array of String 否 vbr-m5ex0xf63xk8s5bob****,vbr-bp1h6efd7a5g66xxd****

接受授权的VBR实例。多个VBR实例间使用半角逗号（,）分隔。

  • 当GrantType取值为All时，该参数可以为空，表示将VPC实例授权给指定地域和阿里云账号（主账号）下所有的VBR实例。
  • 当GrantType取值为Specify时，该参数需要配置，表示将VPC实例授权给指定VBR实例。
InstanceId String 是 vpc-bp1lqhq93q8evjpky****

要授权的VPC实例ID。
GrantType String 是 All

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

  • All：将VPC实例授权给指定地域和阿里云账号（主账号）下所有的VBR实例，此时VbrInstanceIds参数可以为空。
  • Specify：将VPC实例授权给指定VBR实例，此时VbrInstanceIds参数需要配置。
VbrRegionNo String 是 cn-hangzhou

接受授权的VBR实例所在的地域ID。

返回数据

名称 类型 示例值 描述
RequestId String F99F13AE-D733-5856-AB97-80CC88B1D5A8

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GrantInstanceToVbr
&RegionId=cn-hangzhou
&VbrOwnerUid=1210123456123456
&VbrInstanceIds=["vbr-m5ex0xf63xk8s5bob****,vbr-bp1h6efd7a5g66xxd****"]
&InstanceId=vpc-bp1lqhq93q8evjpky****
&GrantType=All
&VbrRegionNo=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

<GrantInstanceToVbrResponse>
    <RequestId>F99F13AE-D733-5856-AB97-80CC88B1D5A8</RequestId>
</GrantInstanceToVbrResponse>

JSON格式

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

{
  "RequestId" : "F99F13AE-D733-5856-AB97-80CC88B1D5A8"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParam.NotNull The parameter must not be null. 参数不能为空。
400 Parameter.Illegal The parameter is illegal. 参数非法
400 Instance.StatusError The status of instance error. 实例状态错误。
404 Instance.NotExist The instance not exist. 实例不存在。

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