すべてのプロダクト
Search

このプロダクト

    :UpdateVirtualPhysicalConnection

    ドキュメントセンター

    :UpdateVirtualPhysicalConnection

    最終更新日:Mar 16, 2025

    ホスト接続の仮想ローカルエリアネットワーク (VLAN) ID を変更します。

    デバッグ

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

    リクエストパラメーター

    パラメーター タイプ 必須 例 説明
    Action String Yes UpdateVirtualPhysicalConnection

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

    VlanId Long Yes 1

    ホスト接続の VLAN ID。有効な値：0 ～ 2999。

    • VLAN ID が 0 に設定されている場合、仮想ボーダールータ (VBR) のスイッチポートは VLAN インターフェースではなく、レイヤー 3 ルーターインターフェースであることを示します。レイヤー 3 ルーターインターフェースを使用する場合、各 Express Connect 回線は 1 つの VBR に対応します。
    • VLAN ID が 1 ～ 2999 の値に設定されている場合、VBR のスイッチポートはレイヤー 3 VLAN サブインターフェースです。レイヤー 3 VLAN サブインターフェースを使用する場合、各 VLAN ID は 1 つの VBR に対応します。この場合、VBR が関連付けられている Express Connect 回線を使用して、異なる Alibaba Cloud アカウントに属する VPC に接続できます。異なる VLAN の VBR はレイヤー 2 で互いに分離されています。
    InstanceId String Yes pc-bp1mrgfbtmc9brre7****

    共有 Express Connect 回線の ID。

    Token String No CBCE910E-D396-4944-8****

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

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

    説明 このパラメーターを指定しない場合、システムは自動的に RequestId を ClientToken として使用します。各 API リクエストの RequestId の値は異なる場合があります。
    DryRun Boolean No false

    操作を実行せずにリクエストを確認するかどうかを指定します。有効な値：

    • true: 操作を実行せずにリクエストを確認します。ホスト接続の VLAN ID は変更されません。システムは、必須パラメーター、リクエスト構文、およびインスタンスステータスを確認します。チェックに失敗した場合、対応するエラーメッセージが返されます。リクエストがチェックに合格した場合、システムはリクエストの ID を返します。
    • false (デフォルト): リクエストを送信します。リクエストがチェックに合格した場合、ホスト接続の VLAN ID が変更されます。
    ExpectSpec String No 50M

    ホスト接続の推定帯域幅値。推定帯域幅値は、支払いが完了した後に有効になります。

    有効な値：50M、100M、200M、300M、400M、500M、1G、2G、5G、8G、10G。

    説明 デフォルトでは、2G、5G、8G、10G の値は使用できません。これらの値を指定する場合は、カスタマーマネージャーにお問い合わせください。

    M は Mbit/s を、G は Gbit/s を示します。

    RegionId String Yes cn-hangzhou

    ホスト接続のリージョン ID。

    DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。

    レスポンスパラメーター

    パラメーター タイプ 例 説明
    RequestId String 7035627E-1C1D-5BC7-A830-F897A35912D1

    リクエストの ID。

    Success String true

    ホスト接続の VLAN ID が変更されたかどうかを示します。有効な値：

    • true: ホスト接続の VLAN ID が変更されました。
    • false: ホスト接続の VLAN ID は変更されていません。

    例

    リクエストの例

    http(s)://[Endpoint]/?Action=UpdateVirtualPhysicalConnection
&VlanId=1
&InstanceId=pc-bp1mrgfbtmc9brre7****
&Token=CBCE910E-D396-4944-8****
&DryRun=false
&ExpectSpec=50M
&RegionId=cn-hangzhou
&共通リクエストパラメーター

    成功レスポンスの例

    XML 形式

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

<UpdateVirtualPhysicalConnectionResponse>
    <RequestId>7035627E-1C1D-5BC7-A830-F897A35912D1</RequestId>
    <Success>true</Success>
</UpdateVirtualPhysicalConnectionResponse>

    JSON 形式

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

{
  "RequestId" : "7035627E-1C1D-5BC7-A830-F897A35912D1",
  "Success" : "true"
}

    エラーコード

    HttpCode エラーコード エラーメッセージ 説明
    400 IllegalParam.VlanId The param of VlanId is illegal. VlanId パラメーターが無効な値に設定されているために返されるエラーメッセージ。
    400 ResourceNotFound.PhysicalConnectionId The specified PhysicalConnectionId [%s] is not found. ホスト接続の ID が見つからないために返されるエラーメッセージ。
    400 ResourceNotEnough.Bandwidth The specified resource of Bandwidth is not enough. 帯域幅リソースが不足しているために返されるエラーメッセージ。
    400 IllegalParam.Bandwidth The param of bandwidth is illegal. 帯域幅パラメーターが無効な値に設定されているために返されるエラーメッセージ。
    400 OperationDenied.CreateVpconn You are not allowed to create virtual physical connection. Please contact you CBM. ホスト接続を作成する権限がないために返されるエラーメッセージ。アカウントマネージャーにお問い合わせください。
    400 Forbidden.PhysicalConnection Only parent physical connection account is allowed to modify the virtual physical connection. 共有ポートが属する物理ポートのみを変更できるために返されるエラーメッセージ。

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