すべてのプロダクト
Search
ドキュメントセンター

Virtual Private Cloud:DescribeVSwitchAttributes

最終更新日:Apr 27, 2026

vSwitch の詳細情報をクエリします。

今すぐお試しください

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

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

VSwitchId

string

必須

vSwitch の ID です。

vsw-25naue4g****

RegionId

string

任意

vSwitch が属する VPC のリージョン ID です。

最新のリージョン一覧を取得するには、DescribeRegions 操作を呼び出してください。

cn-hangzhou

DryRun

boolean

任意

実際のリクエストを実行せずにドライランのみを行うかどうかを指定します。有効値は次のとおりです。

  • true:ドライランのみを実行します。システムは、パラメーター値の欠落、リクエスト構文の誤り、サービス制限など、潜在的な問題についてリクエストをチェックします。ドライランに失敗した場合はエラーメッセージが返されます。ドライランに成功した場合は、DryRunOperation エラーコードが返されます。

  • false(デフォルト):リクエストを送信し、ドライランを実行します。ドライランに成功した場合は、2xx HTTP ステータスコードが返され、操作が実行されます。

false

レスポンスフィールド

フィールド

説明

object

vSwitch の詳細情報です。

VpcId

string

vSwitch が属する VPC の ID です。

vpc-257gq642n****

Status

string

vSwitch のステータスです。有効値は次のとおりです。

  • Pending

  • Available

Pending

CreationTime

string

vSwitch の作成時刻です。

2021-08-22T10:40:25Z

IsDefault

boolean

vSwitch がデフォルト vSwitch かどうかを示します。有効値は次のとおりです。

  • true

  • false

false

AvailableIpAddressCount

integer

利用可能な IP アドレスの数です。

12

NetworkAclId

string

ネットワークアクセスコントロールリスト (ACL) ルールです。

1

OwnerId

integer

リソースが属する Alibaba Cloud アカウントの ID です。

28768383240243****

VSwitchId

string

vSwitch ID です。

vsw-25b7pv15t****

RequestId

string

リクエスト ID です。

7B48B4B9-1EAD-469F-B488-594DAB4B6A1A

CidrBlock

string

vSwitch の CIDR ブロックです。

192.168.0.1/24

Description

string

vSwitch の説明です。

abc

ResourceGroupId

string

ACL が属するリソースグループの ID です。

rg-acfmxazb4ph****

ZoneId

string

vSwitch が属するゾーンの ID です。

cn-beijing-a

Ipv6CidrBlock

string

vSwitch の IPv6 CIDR ブロックです。

2408:XXXX:3c5:44e::/64

VSwitchName

string

vSwitch 名です。

test

ShareType

string

vSwitch が共有されているかどうかを示します。

  • 値が返されない場合、vSwitch は通常の vSwitch です。

  • Shared が返される場合、vSwitch は共有されています。

  • Sharing が返される場合、vSwitch は共有中です。

Shared

EnabledIpv6

boolean

vSwitch で IPv6 が有効かどうかを示します。IPv6 を有効にする場合は、vSwitch の IPv6 CIDR ブロックを設定する必要があります。有効値は次のとおりです。

  • true

  • false

このフィールドは、vSwitch で IPv6 が有効な場合にのみ返されます。

true

RouteTable

object

vSwitch に関連付けられたルートテーブルの情報です。

RouteTableId

string

vSwitch に関連付けられたルートテーブルの ID です。

vtb-bp145q7glnuzdv****

RouteTableType

string

ルートテーブルのタイプです。有効値は次のとおりです。

  • System

  • Custom

System

Tags

object

Tag

array<object>

タグの情報です。

object

Key

string

リソースに追加されたタグ N のキーです。

FinanceDept

Value

string

リソースに追加されたタグ N の値です。

FinanceJoshua

成功レスポンス

JSONJSON

{
  "VpcId": "vpc-257gq642n****",
  "Status": "Pending",
  "CreationTime": "2021-08-22T10:40:25Z",
  "IsDefault": false,
  "AvailableIpAddressCount": 12,
  "NetworkAclId": "1",
  "OwnerId": 0,
  "VSwitchId": "vsw-25b7pv15t****",
  "RequestId": "7B48B4B9-1EAD-469F-B488-594DAB4B6A1A",
  "CidrBlock": "192.168.0.1/24",
  "Description": "abc",
  "ResourceGroupId": "rg-acfmxazb4ph****",
  "ZoneId": "cn-beijing-a",
  "Ipv6CidrBlock": "2408:XXXX:3c5:44e::/64",
  "VSwitchName": "test",
  "ShareType": "Shared",
  "EnabledIpv6": true,
  "RouteTable": {
    "RouteTableId": "vtb-bp145q7glnuzdv****",
    "RouteTableType": "System"
  },
  "Tags": {
    "Tag": [
      {
        "Key": "FinanceDept",
        "Value": "FinanceJoshua"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidVSwitchId.NotFound Specified VSwitch can not found.

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

変更履歴

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