调用GrantInstanceToVbr接口将跨账号创建VBR上连场景的VPC实例授权给VBR实例。
接口说明
本接口用于跨账号场景,调用前需确保以下资源已就绪:
账号 A(VPC 所有者,即本接口调用方):
已创建 VPC 且状态为 Available(CreateVpc)。
账号 B(VBR 所有者,即 VbrOwnerUid 指定账号): 当 GrantType=Specify 时, VbrInstanceIds 中的 VBR 必须已创建完成。创建 VBR 依赖完整的物理连接生命周期链:
调用 CreatePhysicalConnection 创建物理连接;
申请 LOA 并完成施工(ApplyPhysicalConnectionLOA → CompletePhysicalConnectionLOA), 物理连接进入 Confirmed 状态;
调用 EnablePhysicalConnection 启用物理连接(要求物理连接处于 Confirmed 状态);
调用 CreateVirtualBorderRouter 创建 VBR(要求物理连接处于 Enabled 状态, 否则返回 InvalidPhysicalConnectionId.NotEnabled)。
完成上述准备后,账号 A 调用本接口将 VPC 授权给账号 B 的 VBR:
GrantType=All:授权账号 B 名下所有 VBR(仅校验 VbrOwnerUid 合法性,VBR 可尚未创建);
GrantType=Specify:授权指定 VBR,VbrInstanceIds 中的实例必须已存在于 VbrOwnerUid 账号的 VbrRegionNo 地域下,否则返回 Instance.NotExist。
注意:VbrOwnerUid 不能与调用方账号相同,否则返回 Parameter.Illegal。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vpc:GrantInstanceToVbr |
update |
*VPC
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
要授权的 VPC 实例所在的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
| VbrOwnerUid |
integer |
是 |
接受授权的 VBR 实例所属阿里云账号(主账号)ID。该账号必须与调用方账号不同,不能填写调用方自身账号 ID;本接口用于跨账号授权。 |
1210123456123456 |
| VbrInstanceIds |
array |
否 |
接受授权的 VBR 实例的列表信息。 |
|
|
string |
否 |
接受授权的 VBR 实例。多个 VBR 实例间使用半角逗号(,)分隔。
|
vbr-m5ex0xf63xk8s5bob****,vbr-bp1h6efd7a5g66xxd**** |
|
| InstanceId |
string |
是 |
要授权的 VPC 实例 ID。 |
vpc-bp1lqhq93q8evjpky**** |
| GrantType |
string |
是 |
接受授权的 VBR 实例的范围。取值:
|
All |
| VbrRegionNo |
string |
是 |
接受授权的 VBR 实例所在的地域 ID。 |
cn-hangzhou |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应数据结构。 |
||
| RequestId |
string |
请求 ID。 |
F99F13AE-D733-5856-AB97-80CC88B1D5A8 |
示例
正常返回示例
JSON格式
{
"RequestId": "F99F13AE-D733-5856-AB97-80CC88B1D5A8"
}
错误码
|
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. | 实例状态错误。 |
| 404 | Instance.NotExist | The instance not exist. | 实例不存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。