CreateTransitRouterVpcAttachment 操作を呼び出し、Virtual Private Cloud (VPC) インスタンスを Enterprise Edition のトランジットルーターインスタンスにアタッチして、プライベートネットワークピアリングを有効にします。アタッチメントの作成後、トランジットルーターインスタンスによる転送およびルーティングを通じて、プライベートネットワーク接続性を実現できます。
操作説明
-
Enterprise Edition のトランジットルーターの VPC アタッチメントは、次の 2 つの方法で作成できます。
対象リージョンに Enterprise Edition のトランジットルーターインスタンスが既に作成されている場合は、VpcId、ZoneMappings.N.VSwitchId、ZoneMappings.N.ZoneId、TransitRouterId、および RegionId を指定して VPC アタッチメントを作成します。
対象リージョンに Enterprise Edition のトランジットルーターインスタンスが作成されていない場合は、VpcId、ZoneMappings.N.VSwitchId、ZoneMappings.N.ZoneId、CenId、および RegionId を指定して VPC アタッチメントを作成します。VPC アタッチメントの作成時に、システムは自動作成を使用して Enterprise Edition のトランジットルーターインスタンスを作成します。
-
CreateTransitRouterVpcAttachment は非同期操作です。システムは、VPC アタッチメントが作成される前に VPC アタッチメント ID を返します。作成タスクはバックグラウンドで実行されます。VPC アタッチメントのステータスをクエリするには、 ListTransitRouterVpcAttachments を呼び出します。
VPC アタッチメントが Attaching 状態の場合、VPC アタッチメントの作成中です。この状態では、VPC アタッチメントのクエリのみが可能で、他の操作を実行することはできません。
VPC アタッチメントが Attached 状態の場合、VPC アタッチメントの作成が完了しています。
-
VPC アタッチメントの作成後、デフォルトでは、ルート学習関係または転送関係のためにトランジットルータールートテーブルに関連付けられません。
開始する前に
この操作を呼び出して VPC アタッチメントを作成する前に、次の要件が満たされていることを確認してください。
VPC インスタンスには、Enterprise Edition のトランジットルーターでサポートされているゾーンに、使用可能な IP アドレスが少なくとも 1 つある vSwitch インスタンスが少なくとも 1 つ存在すること。Enterprise Edition のトランジットルーターでサポートされているリージョンとゾーンの詳細については、「Enterprise Edition のトランジットルーターでサポートされているリージョンとゾーン」を参照してください。
別のアカウントに属する VPC 接続インスタンスをアタッチする場合は、事前にクロスアカウントの権限付与を取得してください。詳細については、「クロスアカウント VPC 接続インスタンスの権限付与」を参照してください。
VPC アタッチメントの作成には料金が発生します。課金ルールを理解していることを確認してください。詳細については、「課金」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cen:CreateTransitRouterVpcAttachment |
create |
CenInstance。
TransitRouter。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 このパラメーターには、クライアントから生成された一意の値を指定します。ClientToken は ASCII 文字のみをサポートします。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。各 API リクエストの RequestId は異なります。 |
02fb3da4-130e-11e9-8e44-001**** |
| CenId |
string |
任意 |
Cloud Enterprise Network (CEN) のインスタンス ID。 |
cen-j3jzhw1zpau2km**** |
| TransitRouterId |
string |
任意 |
Enterprise Edition のトランジットルーターのインスタンス ID。 |
tr-bp1su1ytdxtataupl**** |
| RegionId |
string |
任意 |
VPC インスタンスがデプロイされているリージョンの ID。 DescribeChildInstanceRegions を呼び出してリージョン ID をクエリできます。 |
cn-hangzhou |
| TransitRouterAttachmentName |
string |
任意 |
VPC アタッチメントの名前。 名前は空のままにするか、1～128 文字で指定できます。http:// または https:// で始めることはできません。 |
testname |
| TransitRouterAttachmentDescription |
string |
任意 |
VPC アタッチメントの説明。 説明は空のままにするか、1～256 文字で指定できます。http:// または https:// で始めることはできません。 |
testname |
| VpcId |
string |
必須 |
VPC のインスタンス ID。 |
vpc-bp1kbjcre9vtsebo1**** |
| VpcOwnerId |
integer |
任意 |
VPC インスタンスが属する Alibaba Cloud アカウントの ID。デフォルト値は、現在ログインしている Alibaba Cloud アカウントの ID です。 説明
別のアカウントに属するネットワークインスタンスをアタッチする場合は、このパラメーターが必須です。 |
1250123456123456 |
| ChargeType |
string |
任意 |
課金方法。デフォルト値: POSTPAY (従量課金方法)。 |
POSTPAY |
| DryRun |
boolean |
任意 |
リクエストに対して、権限チェックやインスタンスステータスの検証を含むドライランを実行するかどうかを指定します。有効な値:
|
false |
| ZoneMappings |
array<object> |
必須 |
Enterprise Edition のトランジットルーターでサポートされているゾーンの vSwitch インスタンスを選択します。 一度に最大 10 エントリを追加できます。 |
|
|
object |
任意 |
Enterprise Edition のトランジットルーターでサポートされているゾーンと、対応する vSwitch インスタンスに関する情報。 |
||
| VSwitchId |
string |
必須 |
Enterprise Edition のトランジットルーターでサポートされているゾーンの vSwitch インスタンス。 一度に最大 10 ゾーンの vSwitch インスタンスを選択できます。 |
vsw-bp1a214sbus8z3b54**** |
| ZoneId |
string |
必須 |
Enterprise Edition のトランジットルーターでサポートされているゾーンの ID。 DescribeZones を呼び出してゾーン ID をクエリできます。 一度に最大 10 ゾーンを選択できます。 |
cn-hangzhou-h |
| AutoPublishRouteEnabled |
boolean |
任意 |
Enterprise Edition のトランジットルーターが VPC インスタンスにルートエントリを自動的に公開するかどうかを指定します。
|
true |
| TransitRouterVPCAttachmentOptions |
object |
任意 |
VPC アタッチメントの特徴属性のリスト (非推奨予定 - 代わりに新しい Options パラメーターを使用してください)。 |
|
|
string |
任意 |
VPC アタッチメントの特徴属性 (非推奨予定 - 代わりに新しい Options パラメーターを使用してください)。 ipv6Support: IPv6 を有効にするかどうかを指定します。
説明
VPC アタッチメントで IPv6 を有効にする前に、VPC インスタンスとそれに関連付けられた vSwitch インスタンスで IPv6 が有効になっていることを確認してください。詳細については、 AllocateVpcIpv6Cidr および CreateVSwitchCidrReservation を参照してください。 |
disable |
|
| Tag |
array<object> |
任意 |
タグのリスト。 一度に最大 20 個のタグを指定できます。 |
|
|
object |
任意 |
タグ。 |
||
| Key |
string |
任意 |
リソースのタグキー。 このパラメーターを指定する場合、空文字列にすることはできません。タグキーは最大 64 文字で、 一度に最大 20 個のタグキーを指定できます。 |
tagtest |
| Value |
string |
任意 |
リソースのタグ値。 このパラメーターを指定する場合、空にすることはできません。タグ値は最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。 各タグキーは 1 つのタグ値に対応します。一度に最大 20 個のタグキーとタグ値のペアを指定できます。 |
tagtest |
| Options |
object |
任意 |
特徴属性のコレクション。 |
|
| ApplianceModeSupport |
string |
任意 |
ネットワークアプライアンスのトラフィックリダイレクトモードを有効にするかどうかを指定します。
|
enable |
| Ipv6Support |
string |
任意 |
IPv6 サポートを有効にするかどうかを指定します。
|
enable |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答結果。 |
||
| RequestId |
string |
リクエスト ID。 |
C087A369-82B9-43EF-91F4-4B63A9C6E6B6 |
| TransitRouterAttachmentId |
string |
VPC アタッチメントの ID。 |
tr-attach-ia340z7xis7t5s**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6",
"TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | OperationUnsupported.TransitRouterRegionId | The specified TransitRouterRegion does not support the operation. | |
| 400 | NoPermission.AliyunServiceRoleForCEN | You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. | サービスリンクロールを作成する権限がありません。ロール名: AliyunServiceRoleForCEN。サービス名: cen.aliyuncs.com。現在のユーザーに ram:CreateServiceLinkedRole 権限が付与されていることを確認してください。 |
| 400 | IllegalParam.RegionId | The Specified Parameter RegionId is illegal | リクエストで指定された Region が無効です。 |
| 400 | MissingParam.CenIdOrRegionId | Either CenId or RegionId must be specified. | CenId または RegionId は必須パラメーターです。 |
| 400 | IllegalParam.ZoneId | The specified ZoneId is illegal. | 指定されたゾーンは無効です。 |
| 400 | IllegalParam.ChargeType | The specified ChargeType is illegal. | 課金方法が無効です。 |
| 400 | InvalidTransitRouterId.NotFound | The specified TransitRouterId is not found. | 対応するトランジットルーターが見つかりません。 |
| 400 | IncorrectStatus.VpcResource | The resource is not in a valid state for the attachment operation. | VPC リソースが安定した状態ではないため、操作できません。現在の VPC に対する関連する操作が完了するまで待機してから、リトライしてください。 |
| 400 | IncorrectStatus.Vpc | The resource is not in a valid state for the attachment operation. | VPC の現在の状態ではこの操作に対応していません。しばらくしてからもう一度お試しください。 |
| 400 | IncorrectStatus.VpcOrVswitch | The Vpc Or Vswith is not in a valid state for the attachment operation. | VPC または vSwitch の現在の状態ではこの操作に対応していません。しばらくしてからもう一度お試しください。 |
| 400 | OperationNotSupport.VpcAutoRoutesPublish | Auto publish vpc routes is not supported in this region. | 現在のリージョンでは、VPC の自動ルート広告はサポートされていません。 |
| 400 | InvalidOperation.VpnAssociated | The operation is not supported because the VPC is associated with VPN. | 現在の VPC は VPN にアタッチされています。ルーティングの自動同期の特徴は有効にできません。 |
| 400 | Forbbiden.TransitRouterServiceNotOpen | The user has not open transit router service. | トランジットルーターサービスが有効化されていません。サービスを有効化してから、再度お試しください。 |
| 400 | IllegalParam.ZoneMappings | The Specified Parameter ZoneMappings is illegal | パラメーターに指定された ZoneMappings は無効です。 |
| 400 | OperationUnsupported.TransitRouterType | The specified TransitRouterType does not support the operation. | 現在のトランジットルーターのタイプでは、この操作はサポートされていません。 |
| 400 | InvalidCenId.NotFound | CenId is not found. | CEN インスタンスが存在しません。 |
| 400 | IllegalParam.VSwitchId | VSwitchId is illegal. | パラメーターに指定された VSwitchId は無効です。 |
| 400 | IncorrectStatus.TransitRouterInstance | The status of TransitRouter is incorrect. | トランジットルーターが無効な状態です。 |
| 400 | OperationUnsupported.CenFullLevel | CEN full level does not support TransitRouter | Full タイプの CEN インスタンスでは、Enterprise Edition のトランジットルーターの作成はサポートされていません。 |
| 400 | IllegalParam.ServiceMode | ServiceMode is illegal. | サービスモードが無効です。 |
| 400 | QuotaFull.ChildInstanceRelatedCen | The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment. | このインスタンスに関連付けられている CEN インスタンスの数が上限に達しました。インスタンスをロードできません。 |
| 400 | OperationUnsupported.CloudBoxVswNotSupport | Cloud Box vsw does not support. | CloudBox の vSwitch はロードできません。 |
| 400 | IncorrectStatus.TransitRouter | The status of TransitRouter is incorrect. | トランジットルーターの現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。 |
| 400 | Duplicated.ZoneMapping | The parameter ZoneMapping is duplicated. | ZoneMapping に重複するエントリが含まれています。 |
| 400 | QuotaExceeded.CenQuotaVpcAttachPerTransitRouter | The maximum number of VPC attachment per Transit Router is exceeded. | 各トランジットルーターに接続できる仮想非公開クラウド (VPC) の数が制限を超えました。 |
| 400 | IncorrectStatus.VpcRouteTable | The VPC route table is not in a desired state. | この操作に関連付けられた VPC ルートテーブルが安定した状態ではないため、操作できません。しばらくしてからもう一度お試しください。 |
| 400 | InvalidStatus.VpcAttachedFullModeCen | The VPC has been attached to another CEN instance whose protection level is FULL. | リクエストで指定された VPC は、すでに保護レベルが FULL に設定されている別の CEN インスタンスにアタッチされているため、他の CEN インスタンスにアタッチすることはできません。 |
| 400 | Forbbiden.AttachChildInstanceAcrossBid | VPCs that belong to another BID cannot be associated. You need to apply for cross-BID attaching. | 異なる bid アカウント配下の VPC を関連付けることは許可されていません。 |
| 400 | InvalidOperation.VpcAutoRoutesPublishInOtherCEN | The specified VPC already has its routes synchronized with another CEN instance. | 現在の VPC では、すでに別の CEN インスタンスでルーティングの自動同期が有効になっています。この操作はサポートされていません。 |
| 400 | QuotaExceeded.VpcAutoRoutesPublishPerTransitRouter | The number of VPCs that have route synchronization enabled has reached the upper limit. | ルーティングの自動同期が有効になっている VPC の数が上限に達しました。 |
| 400 | InsufficientIpAddr.vsw | Insufficient available IP addresses in the vSwitch. | vSwitch 内のアクティブな IP アドレスの数が不足しています。 |
| 400 | Forbidden.ResourceOwnerTransitRouterServiceNotOpen | The resource owner user has not opened transit router service. | リソースのオーナーであるアカウントのトランジットルーターサービスが有効化されていません。アカウントオーナーにサービスを有効化するよう通知してから、再度お試しください。 |
| 400 | IllegalParam.TransitRouterRegionId | TransitRouterRegionId is illegal. | TransitRouterRegionId は無効です。 |
| 400 | InvalidTransitRouterMode.NeedUpgrade | TransitRouter need to upgrade. | 現在のトランジットルーターモードはサポートされていません。 |
| 400 | IllegalParam.Ipv6Support | Ipv6Support is illegal. Valid Values are [enable, disable]. | Ipv6Support リクエストパラメーターの値が無効です。有効な値: enable、disable。 |
| 400 | OperationFailed.VSwitchNotFound | The specified vswitch not found. | 指定された VSwitchId は存在しません。vSwitch が利用可能かどうかを確認するか、別の利用可能な vSwitch を指定してください。 |
| 400 | OperationFailed.VSwitchIpv6CidrNotAllocated | The specified vswitch does not have IPv6 address allocated. | 指定された vSwitch では IPv6 が有効になっていません。この操作を実行する前に IPv6 を有効にしてください。 |
| 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 | ParamExclusive.TransitRouterVPCAttachmentOptionsAndOptions | When creating or modifying a VPC attachment, the input parameter TransitRouterVPCAttachmentOptions and Options cannot be used at the same time. | VPC ネットワーク接続の作成または変更時、TransitRouterVPCAttachmentOptions パラメーターと Options パラメーターを同時に使用することはできません。 |
| 400 | InvalidParameter.ApplianceModeSupport | The specified parameter ApplianceModeSupport is invalid. | ApplianceModeSupport (アプライアンスモードサポート) パラメーターが無効です。 |
| 400 | InvalidParameter.Ipv6Support | The specified parameter Ipv6Support is invalid. | 指定された Ipv6Support (IPv6 サポート) パラメーターが無効です。 |
| 400 | INVALID_OPERATION_RESOURCE_NOT_SUPPORT_APPLIANCE_MODE | Only VPC attachment support appliance mode. | VPC ネットワーク接続性のみがネットワーク要素のトラフィックリダイレクトパターンをサポートします。 |
| 400 | InvalidParameter.TagValue | The specified parameter TagValue is invalid. | 指定されたタグ値パラメーターは無効です。 |
| 400 | InvalidParameter.CenBandwidthPackageId | The specified parameter CenBandwidthPackageId is invalid. | 指定された CenBandwidthPackageId パラメーターが無効です。 |
| 400 | InvalidParameter.CenId | The specified parameter CenId is invalid. | 指定された CenId パラメーターが無効です。 |
| 400 | InvalidParameter.TransitRouterId | The specified parameter TransitRouterId is invalid. | 指定された TransitRouterId パラメーターは無効です。 |
| 400 | InvalidParameter.AssociateRouteTableId | The specified parameter AssociateRouteTableId is invalid. | AssociateRouteTableId パラメーターが無効です。 |
| 400 | OperationFailed.PostPay95BwpNotAllowEnterpriseTr | Cbn with post pay 95 bandwidth package does not allow enterprise tr. | レガシ 95 パーセンタイル帯域幅プランを使用する CEN インスタンスでは、Enterprise Edition トランジットルーターの作成はサポートされていません。 |
| 400 | OperationUnsupported.VpcRoutePropagationSource | The operation on this VPC route propagation source is not supported. | この VPC ルート伝播ソースに対する操作はサポートされていません。 |
| 404 | InvalidVSwitchId.NotFound | The specified VSwitchId is not found. | 指定された VSwitchId は存在しません。 |
| 409 | InvalidOperation.CenInstanceStatus | The CEN instance is not in a valid state for the operation. | 現在の CEN のステータスでは、この操作はサポートされていません。後でもう一度お試しください。 |
| 409 | IncorrectStatus.VpcSwitch | The resource is not in a valid state for the attachment operation. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。