建立一個交換器。

調用該介面建立交換器時，請注意：

  • 每個VPC內的交換器數量不能超過24個。

  • 每個交換器網段的第一個和最後個IP地址為系統保留地址。以192.168.1.0/24為例，192.168.1.0、192.168.1.253、192.168.1.254和192.168.1.255這些地址是系統保留地址。

  • 交換器下的雲產品執行個體數量不允許超過VPC剩餘的可用雲產品執行個體數量（15000減去當前雲產品執行個體數量）。

  • 一個雲產品執行個體只能屬於一個交換器。

  • 交換器不支援組播和廣播。 交換器建立成功後，網段無法修改。

請求參數

名稱 類型 是否必須 描述
String 是

要執行的操作。 取值：

CreateVSwitch
ZoneId String 是

交換器所屬區的ID。

您可以通過調用 DescribeZones介面獲取地域ID。

CidrBlock String 是

交換器的網段。交換器網段要求如下：

  • 交換器網段的掩碼長度範圍為16-29位。
  • 交換器的網段必須從屬於所在VPC的網段。
  • 交換器的網段不能與所在VPC中路由條目的目標網段相同，但可以是目標網段的子集 。
  • 如果交換器的網段與所在VPC的網段相同時，VPC只能有一個交換器。
VpcId String 是

交換器所屬的VPC ID。
VSwitchName String 否

交換器的名稱。

長度為 2-256個字元，必須以字母或中文開頭，但不能以http:// 或https://開頭。

Description String 否

交換器的描述資訊。

長度為 2-256個字元，必須以字母或中文開頭，但不能以http:// 或https://開頭。

ClientToken String 否

用戶端token，用於保證請求的等冪性。

由用戶端生成該參數值，要保證在不同請求間唯一，最大不值過64個 ASCII 字元。

返回參數

名稱 類型 描述
RequestId String 請求ID。
VSwitchId String 交換器的ID。

樣本

請求樣本

https://vpc.aliyuncs.com/?Action=CreateVSwitch
&CidrBlock=172.16.1.0/24
&VpcId=vpc-257gq642n
&ZoneId=cn-beijing-a
&公共請求參數
返回樣本

  • XML格式

    <?xml version="1.0" encoding="UTF-8"?>
<CreateVSwitchResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <VSwitchId>vsw-25naue4gz</VSwitchId>
</CreateVSwitchResponse>

  • JSON格式

    { 
    "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0", 
    "VSwitchId": "vsw-25naue4gz"
}