GrantInstanceToVbr - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

操作説明

この操作はクロスアカウントシナリオで使用されます。この操作を呼び出す前に、以下のリソースが準備できていることを確認してください。

アカウント A (VPC オーナー、この操作の呼び出し元):

VPC が作成されており、Available 状態であること (CreateVpc)。

アカウント B (VBR オーナー、VbrOwnerUid で指定されるアカウント): GrantType=Specify の場合、VbrInstanceIds で指定された VBR が既に作成されている必要があります。VBR の作成は、Express Connect 回線の完全なライフサイクルに依存します。

CreatePhysicalConnection を呼び出して Express Connect 回線を作成します。
権限付与書 (LOA) を申請し、工事を完了します (ApplyPhysicalConnectionLOA → CompletePhysicalConnectionLOA)。Express Connect 回線が Confirmed 状態になります。
EnablePhysicalConnection を呼び出して Express Connect 回線を有効化します (回線は Confirmed 状態である必要があります)。
CreateVirtualBorderRouter を呼び出して VBR を作成します (Express Connect 回線は Enabled 状態である必要があります。そうでない場合、エラー InvalidPhysicalConnectionId.NotEnabled が返されます)。

上記の準備が完了した後、アカウント A はこの操作を呼び出して、VPC の権限付与をアカウント B の VBR に付与します。

GrantType=All: アカウント B 配下のすべての VBR に権限付与を行います (VbrOwnerUid の有効性のみが検証されます。VBR はまだ作成されている必要はありません)。
GrantType=Specify: 指定された VBR に権限付与を行います。VbrInstanceIds 内のインスタンスは、VbrOwnerUid で指定されたアカウントの VbrRegionNo で指定されたリージョンに既に存在している必要があります。そうでない場合、エラー Instance.NotExist が返されます。

注意: VbrOwnerUid は呼び出し元のアカウントと同じにすることはできません。同じ場合、エラー Parameter.Illegal が返されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vpc:GrantInstanceToVbr

update

*VPC。

acs:vpc:{#regionId}:{#AccountId}:vpc/{#VpcId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	権限付与の対象となる VPC 接続インスタンスのリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID をクエリできます。	cn-hangzhou
VbrOwnerUid	integer	必須	権限を付与される VBR インスタンスを所有する Alibaba Cloud アカウントの ID。このアカウントは呼び出し元のアカウントとは異なる必要があります。呼び出し元自身のアカウント ID は指定できません。この操作はクロスアカウントの権限付与に使用されます。	1210123456123456
VbrInstanceIds	array	任意	権限を付与される VBR インスタンスのリスト。
	string	任意	権限付与を受け取る VBR インスタンス。複数の VBR インスタンスはカンマ (,) で区切ります。 GrantType が All に設定されている場合、このパラメーターは空にできます。これは、指定された Alibaba Cloud アカウントの指定されたリージョンにあるすべての VBR インスタンスに対して VPC 接続インスタンスの権限付与が行われることを示します。 GrantType が Specify に設定されている場合、このパラメーターは必須です。これは、指定された VBR インスタンスに対して VPC 接続インスタンスの権限付与が行われることを示します。	vbr-m5ex0xf63xk8s5bob**,vbr-bp1h6efd7a5g66xxd**
InstanceId	string	必須	権限付与の対象となる VPC 接続インスタンスの ID。	vpc-bp1lqhq93q8evjpky****
GrantType	string	必須	権限付与の対象となる VBR インスタンスの範囲。有効な値: All: 指定された Alibaba Cloud アカウントの指定されたリージョンにあるすべての VBR インスタンスに対して VPC 接続インスタンスの権限付与を行います。この場合、VbrInstanceIds パラメーターは空にできます。 Specify: 指定された VBR インスタンスに対して VPC 接続インスタンスの権限付与を行います。この場合、VbrInstanceIds パラメーターは必須です。	All
VbrRegionNo	string	必須	権限を付与される VBR インスタンスのリージョン ID。	cn-hangzhou

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンス構造体。
RequestId	string	リクエスト ID。	F99F13AE-D733-5856-AB97-80CC88B1D5A8

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
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.	インスタンスが存在しません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。