CreateTransitRouterVbrAttachment 操作を呼び出し、仮想ボーダールーター (VBR) ネットワークインスタンスを同じリージョンのトランジットルーターインスタンスに接続します。接続が確立されると、トランジットルーターを使用してプライベートネットワークピアリングを実現できます。
操作説明
-
Enterprise Edition トランジットルーターでサポートされるリージョンおよびゾーンの詳細については、「Cloud Enterprise Network とは」をご参照ください。
-
Enterprise Edition トランジットルーターに VBR 接続を作成するには、以下の方法があります。
対象リージョンに Enterprise Edition トランジットルーターインスタンスが既に作成されている場合は、VbrId、RegionId、TransitRouterId を指定して VBR 接続を作成できます。
対象リージョンに Enterprise Edition トランジットルーターインスタンスがない場合は、VbrId、CenId、RegionId を指定して VBR 接続を作成できます。VBR 接続の作成時に、システムによって Enterprise Edition トランジットルーターインスタンスが自動的に作成されます。
-
CreateTransitRouterVbrAttachment は非同期操作です。リクエストを送信すると、システムは VBR 接続 ID を返しますが、VBR 接続はまだ作成されていません。作成タスクはバックグラウンドで実行されます。ListTransitRouterVbrAttachments を呼び出して、VBR 接続のステータスをクエリできます。
VBR 接続が Attaching 状態の場合、VBR 接続の作成中です。この状態では、VBR 接続のクエリのみが可能で、他の操作は実行できません。
VBR 接続が Attached 状態の場合、VBR 接続の作成が完了しています。
-
トランジットルーターを所有する Alibaba Cloud アカウントと、VBR インスタンスを所有する Alibaba Cloud アカウントは、同じ企業に属している必要があります。
-
トランジットルーターは、同じアカウントまたは異なるアカウントに属する VBR インスタンスへの接続をサポートしています。クロスアカウント VBR 接続を作成する前に、VBR インスタンスオーナーから権限付与を取得してください。詳細については、「クロスアカウントネットワークインスタンスへの権限付与」をご参照ください。
-
VBR 接続の作成後、デフォルトでは VBR 接続はトランジットルーターのルートテーブルとの間でルート学習や関連付け転送の関係を確立しません。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cen:CreateTransitRouterVbrAttachment |
create |
CenInstance
TransitRouter
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は各 API 呼び出しで異なる場合があります。 |
02fb3da4-130e-11e9-8e44-001**** |
| CenId |
string |
任意 |
Cloud Enterprise Network (CEN) インスタンスの ID。 |
cen-j3jzhw1zpau2km**** |
| TransitRouterId |
string |
任意 |
Enterprise Edition トランジットルーターインスタンスの ID。 |
tr-bp1su1ytdxtataupl**** |
| RegionId |
string |
任意 |
VBR インスタンスのリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
cn-hangzhou。 |
| TransitRouterAttachmentName |
string |
任意 |
VBR 接続の名前。 名前は空、または 1～128 文字で、http:// または https:// で始まることはできません。 |
testname。 |
| TransitRouterAttachmentDescription |
string |
任意 |
VBR 接続の説明。 説明は空、または 1～256 文字で、http:// または https:// で始まることはできません。 |
testdesc。 |
| VbrId |
string |
必須 |
VBR インスタンスの ID。 |
vbr-bp1svadp4lq38janc**** |
| VbrOwnerId |
integer |
任意 |
VBR インスタンスを所有する Alibaba Cloud アカウントの ID。デフォルト値は、現在のログインアカウントの Alibaba Cloud アカウント ID です。 説明
異なるアカウントに属するネットワークインスタンスをロードする場合、このパラメーターは必須です。 |
1250123456123456 |
| AutoPublishRouteEnabled |
boolean |
任意 |
Enterprise Edition トランジットルーターが VBR インスタンスにルートエントリを自動的に公開することを許可するかどうかを指定します。
|
false。 |
| DryRun |
boolean |
任意 |
権限やインスタンスステータスの検証を含むドライランを実行するかどうかを指定します。有効な値:
|
false。 |
| Tag |
array<object> |
任意 |
タグ情報。 一度に最大 20 個のタグを指定できます。 |
|
|
object |
任意 |
|||
| Key |
string |
任意 |
リソースのタグキー。 指定されたタグキーは空文字列にすることはできません。タグキーは最大 64 文字で、 一度に最大 20 個のタグキーを指定できます。 |
TagKey。 |
| Value |
string |
任意 |
リソースのタグ値。 指定されたタグ値は空にすることはできません。タグ値は最大 128 文字で、aliyun または acs: で始まったり、http:// または https:// を含んだりすることはできません。 各タグキーは 1 つのタグ値に対応します。一度に最大 20 個のタグ値を指定できます。 |
TagValue。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーター。 |
||
| TransitRouterAttachmentId |
string |
VBR 接続の ID。 |
tr-attach-ia340z7xis7t5s**** |
| RequestId |
string |
リクエスト ID。 |
C087A369-82B9-43EF-91F4-4B63A9C6E6B6 |
例
成功レスポンス
JSONJSON
{
"TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****",
"RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | NoPermission.AliyunServiceRolePolicyForCEN | You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. | サービスリンクロールを作成する権限がありません。ロール名: AliyunServiceRolePolicyForCEN。サービス名: cen.aliyuncs.com。現在のユーザーに ram:CreateServiceLinkedRole 権限が付与されていることを確認してください。 |
| 400 | OperationUnsupported.TransitRouterRegionId | The specified TransitRouterRegion does not support the operation. | |
| 400 | InvalidCenId.NotFound | CenId is not found. | パラメーターで指定された CenId が存在しません。 |
| 400 | InvalidStatus.ResourceStatus | The resource is not in a valid state for the attachment operation. | 現在のリソースステータスでは、この操作はサポートされていません。後でもう一度お試しください。 |
| 400 | InvalidTransitRouterId.NotFound | TransitRouterId is not found. | リクエストに指定された TransitRouterId が存在しません。 |
| 400 | Forbbiden.TransitRouterServiceNotOpen | The user has not open transit router service. | トランジットルーターサービスが有効化されていません。サービスを有効化して、再試行してください。 |
| 400 | OperationUnsupported.TransitRouterType | The specified TransitRouterType does not support the operation. | 現在のトランジットルータータイプでは、この操作はサポートされていません。 |
| 400 | MissingParam.CenIdOrRegionId | Either CenId or RegionId must be specified. | CenId または RegionId は必須パラメーターです。 |
| 400 | IncorrectStatus.Vpc | The resource is not in a valid state for the attachment operation. | VPC の現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。 |
| 400 | Forbidden.VbrDeviceModel | Attach VBR on some access device models are forbidden. | VBR の現在のアクセスモードはこの操作をサポートしていません。 |
| 400 | IllegalParam.AssociateRouteTableId | The specified AssociateRouteTableId is illegal. | リクエストで指定された AssociateRouteTableId が無効です。 |
| 400 | Forbbiden.AttachChildInstanceAcrossBid | Operation is invalid, please apply for cross-bid attaching. | |
| 400 | IllegalParam.RegionId | RegionId is illegal. | リクエストに指定されたリージョンが無効です。 |
| 400 | OperationUnsupported.CenFullLevel | CEN full level does not support TransitRouter | Full モードの CEN インスタンスは VPN BGP をサポートしていません。 |
| 400 | OperationUnsupported.VbrAttachment | This region not support vbr attachment. | このリージョンでは VBR 添付ファイルの読み込みはサポートされていません。 |
| 400 | InvalidOperation.CenInstanceStatus | The CEN instance is not in a valid state for the operation. | |
| 400 | OperationUnsupported.CloudBoxVbrNotSupport | Cloud Box Vbr does not support. | CloudBox インスタンスを読み込めません。 |
| 400 | IncorrectStatus.VbrResource | The resource is not in a valid state for the attachment operation. | VBR リソースが安定した状態ではありません。現在の VBR に対する関連操作が完了するまで待ってから、リトライしてください。 |
| 400 | IncorrectStatus.TransitRouter | The status of TransitRouter is incorrect. | トランジットルーターの現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。 |
| 400 | QuotaExceeded.CenQuotaVbrAttachPerTransitRouter | The maximum number of VBR attachment per Transit Router is exceeded. | 各トランジットルーターに接続できる仮想ボーダールーター (VBR) の数が制限を超えました。クォータを増やすには、チケットを起票してください。 |
| 400 | QuotaFull.ChildInstanceRelatedCen | The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment. | このインスタンスに関連付けられる CEN インスタンス数が上限に達しました。インスタンスを読み込めません。 |
| 400 | Forbidden.ResourceOwnerTransitRouterServiceNotOpen | The resource owner user has not opened transit router service. | リソースを所有するアカウントのトランジットルーターサービスが有効化されていません。アカウントオーナーにサービスの有効化を通知して、再試行してください。 |
| 400 | InvalidOperation.VbrAttachedToEcr | VBR has alreay attached to ECR. | VBR は既に ECR に関連付けられています。 |
| 400 | Forbidden.ResourceOwnerTransitRouterServiceExpired | The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again. | リソースを所有するアカウントのトランジットルーターサービスが支払い遅延により停止されています。アカウントオーナーにサービスの更新を通知して、再試行してください。 |
| 400 | Forbidden.TransitRouterServiceExpired | The transit router service is out of service. | トランジットルーターサービスが支払い遅延により停止されています。サービスを更新して、再試行してください。 |
| 400 | InvalidParameter | Invalid parameter. | パラメーターが無効です。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | アカウントにこの操作を実行する権限がありません。 |
| 400 | InvalidParameter.ResourceType | The specified parameter ResourceType is invalid. | |
| 400 | InvalidParameter.TagValue | The specified parameter TagValue is invalid. | タグ値パラメーターが無効です。 |
| 403 | Forbidden.VbrDeviceModel | The attached VBR on some access device models are not supported. Please submit a ticket to continue using this VBR on CEN. | VBR の現在のアクセスモードはこの操作をサポートしていません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。