edit-icon download-icon

DescribeVSwitches

最終更新日: Mar 05, 2019

説明

作成された VSwitches を照会します。

パラメータを要求する

名前必須かどうか説明
Actionstringはい

実行するアクション。

有効な値: DescribeVSwitches

RegionId stringはい

VSwitch が配置されているリージョンの ID 。

リージョン ID は DescribeRegions API を呼び出して取得できます。

VpcId stringいいえ VPC の ID 。
VSwitchId stringいいえ

VSwitch の ID 。

最大 20 個の VSwitch ID を指定できます。複数の VSwitch ID はコンマで区切ります。

ZoneId stringいいえゾーンの ID 。
IsDefault Booleanいいえ

指定したリージョンのデフォルトの VSwitch を照会するかどうか。有効な値:

  • true (デフォルト値):指定されたリージョンのすべての VSwitch を照会します。

  • false:デフォルトの VSwitch を問い合わせません。

PageNumberIntegerいいえ返すページ数。デフォルト値は 1 です。
PageSizeIntegerいいえ 1 ページあたりの行数。最大値は 50 、デフォルト値は 10 です。

レスポンスパラメータ

名前説明
RequestId string リクエストの ID 。
VSwitches JSON String VSwitche の詳細情報。詳細は、VSwitchSetType を参照してください。
TotalCountInteger照会された項目の数。
PageNumberInteger現在のページ番号。
PageSizeInteger現在のページのエントリ数。

エラーコード

VPC API エラーセンターを参照してください。

リクエストの例

  1. https://vpc.aliyuncs.com/?Action=DescribeVSwitches
  2. &VpcId=vpc-25eq58pl3
  3. &<CommonParameters>

レスポンスの例

XML形式

  1. <DescribeVSwitchesResponse>
  2. <RequestId>9A572171-4E27-40D1-BD36-D26C9E71E29E</RequestId>
  3. <VSwitches>
  4. <VSwitch>
  5. <VSwitchId> vsw-25b7pv15t </VSwitchId>
  6. <Status>Available</Status>
  7. <CidrBlock>172.16.1.0/24</CidrBlock>
  8. <ZoneId>cn-beijing-a</ZoneId>
  9. <AvailableIpAddressCount>246</AvailableIpAddressCount>
  10. <VpcId>vpc-257gq642n</VpcId>
  11. <Description></Description>
  12. <VSwitchName></VSwitchName>
  13. <CreationTime> 2014-10-29T15:21:02Z </CreationTime>
  14. </VSwitch>
  15. </VSwitches>
  16. </DescribeVSwitchesResponse>

JSON形式

  1. {
  2. "PageNumber": 1,
  3. "PageSize": 10,
  4. "RequestId": "9A572171-4E27-40D1-BD36-D26C9E71E29E",
  5. "TotalCount": 1,
  6. "VSwitches": {
  7. "VSwitch": [
  8. {
  9. "AvailableIpAddressCount": 246,
  10. "CidrBlock": "172.16.1.0/24",
  11. "CreationTime": "2014-10-29T15:21:02Z",
  12. "Description": "",
  13. "Status": "Available",
  14. "VSwitchId": "vsw-25b7pv15t",
  15. "VSwitchName": "",
  16. "VpcId": "vpc-257gq642n",
  17. "ZoneId": "cn-beijing-a"
  18. }
  19. ]
  20. }
  21. }