仮想プライベートクラウド (VPC) 接続のゾーンとvSwitchを変更します。

使用上の注意

  • VPC接続にゾーンとvSwitchを追加するときは、vSwitchに少なくとも1つのアイドルIPアドレスがあることを確認してください。 VPC接続のゾーンとvSwitchを変更すると、Enterprise EditionトランジットルーターはvSwitchにelastic network interface (ENI) を作成します。 ENIはvSwitchで1つのIPアドレスを占有します。 ENIは、VPCとEnterprise Editionトランジットルーター間のトラフィックを転送します。
  • UpdateTransitRouterVpcAttachmentZones操作は非同期です。 リクエストを送信すると、システムはリクエストID (RequestId) を返します。 ただし、操作はまだシステムバックグラウンドで実行されています。 ListTransitRouterVpcAttachmentsを呼び出して、VPC接続のステータスを照会できます。
    • VPC接続が [変更] 状態の場合、VPC接続は変更中です。 VPC接続を照会できますが、他の操作は実行できません。
    • VPC接続がアタッチ状態の場合、VPC接続は変更されます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 String 必須 UpdateTransitRouterVpcAttachmentZones

実行する操作です。 値をUpdateTransitRouterVpcAttachmentZonesに設定します。

ClientToken String 任意 123e4567-e89b-12d3-a456-42665544 ****

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 各APIリクエストのRequestIdの値は異なる場合があります。
DryRun Boolean 任意 false

リクエストのみをチェックするかどうかを指定します。 設定可能な値は以下のとおりです。

  • true: リクエストを事前にチェックしますが、VPC接続のゾーンまたはvSwitchは変更しません。 システムは、必要なパラメーター、要求構文、および制限をチェックします。 要求がチェックに失敗した場合、エラーメッセージが返されます。 リクエストがチェックに合格すると、DryRunOperationエラーコードが返されます。
  • false (default): sends the request. リクエストが事前チェックに合格すると、VPC接続のゾーンとvSwitchが変更されます。
TransitRouterAttachmentId String 必須 tr-attach-9bbqyygouv4cpn ****

VPC接続のID。

AddZoneMappings.N.VSwitchId String 任意 vsw-wz988dda8ldm4uvmx ****

VPC接続に追加するvSwitchのID。

各呼び出しで最大10個のvSwitchを指定できます。

  • VPC接続が現在のAlibaba Cloudアカウントに属している場合、DescribeVSwitch操作を呼び出して、VPCのvSwitchゾーンのIDを照会できます。
  • VPC接続が別のAlibaba Cloudアカウントに属している場合、ListGrantVSwitchesToCen操作を呼び出して、VPCのvSwitchゾーンのIDを照会できます。
AddZoneMappings.N.ZoneId String 任意 cn-hangzhou-h

VPC接続に追加するvSwitchがデプロイされているゾーンのID。

各呼び出しで最大10個のvSwitchを指定できます。

RemoveZoneMappings.N.VSwitchId String 任意 vsw-wz9f5izl6wshndmta ****

VPC接続から削除するvSwitchのID。

各呼び出しでVPCから最大10個のvSwitchを削除できます。

RemoveZoneMappings.N.ZoneId String 任意 cn-hangzhou-i

VPC接続から削除するvSwitchがデプロイされているゾーンのID。

各呼び出しでVPCから最大10個のvSwitchを削除できます。

レスポンスパラメーター

パラメーター データ型 説明
RequestId String 595AE52F-49FF-5788-A677-0DD1467941A1

リクエストの ID です。

リクエストの例

http(s)://[Endpoint]/? アクション=UpdateTransitRouterVpcAttachmentZones
&ClientToken=123e4567-e89b-12d3-a456-42665544 ****
&DryRun=false
&TransitRouterAttachmentId=tr-attach-9bbqyygouv4cpn ****
&AddZoneMappings=[{"VSwitchId":"vsw-wz988dda8ldm4uvmx ****","ZoneId":"cn-hangzhou-h"}]
&RemoveZoneMappings=[{"VSwitchId":"vsw-wz9f5izl6wshndmta ****","ZoneId":"cn-hangzhou-i"}]
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式

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

<UpdateTransitRouterVpcAttachmentZonesResponse>
    <RequestId>595AE52F-49FF-5788-A677-0DD1467941A1</RequestId>
</UpdateTransitRouterVpcAttachmentZonesResponse>

JSON 形式

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

{
  "RequestId" : "595AE52F-49FF-5788-A677-0DD1467941A1"
}

エラーコード

エラーコードのリストについては、エラーセンターをご覧ください。