452
新建交換機__交換機相關接口_API 參考_雲服務器 ECS-阿裏雲
描述
在指定 VPC 內創建一個新的VSwitch。
- VSwitch 下的雲產品實例不能分布在不同可用區
- 每個 VPC 的 VSwitch 數量不允許超過 24 個
- 每個 VSwitch 的掩碼為 16 - 29 位，可以提供 8 - 65535 個 IP 地址
- 每個 VSwitch 的第 1 個和最後 3 個 IP 地址為係統保留(以 192.168.1.0 / 24 為例，192.168.1.0 和 192.168.1.255 以及 192.168.1.253 - 254 這些地址是係統保留地址)。
- VSwitch 不支持組播和廣播
- VSwitch 的 CIDRBlock，必須從屬於所在 VPC 的 CIDRBlock
- VSwitch 的 CIDRBlock 可以與所在 VPC 的 CIDRBlock 相同，但這意味著您的 VPC 隻能擁有 1 個 VSwitch
- VSwitch 的 CIDRBlock，不能與所在 VPC 當前 RouteEntry 的 DestCIDRBlock 相同
- VSwitch 的 CIDRBlock，不能包含所在 VPC 當前 RouteEntry 的 DestCIDRBlock，但可以是當前 RouteEntry 的 DestCIDRBlock 的子集
- VSwitch 創建成功後，CidrBlock 無法修改
- VSwitch 下的雲產品實例數量不允許超過 VPC 剩餘的可用雲產品實例數量（5000 - 當前雲產品實例數量）
- 1 個雲產品實例隻能屬於 1 個 VSwitch
請求參數
| 名稱 | 類型 | 是否必須 | 描述 |
|---|---|---|---|
| Action | String | 是 | 係統規定參數，取值：CreateVSwitch |
| ZoneId | String | 是 | 可用區 Id |
| CidrBlock | String | 是 | 指定VSwitch的網段,必須采用CIDR格式來指定IP地址範圍,如 192.168.1.0/24 |
| VpcId | String | 是 | 指定VSwitch所在的 VPC |
| VSwitchName | String | 否 | VSwitch名稱，不填則為空，默認值為空，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數字，”_”或”-”，這個值會展示在控製台。不能以 https:// 和 https:// 開頭。 |
| Description | String | 否 | VSwitch 描述，不填則為空，默認值為空，[2, 256] 英文或中文字符，不能以 https:// 和 https:// 開頭。 |
| ClientToken | String | 否 | 用於保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不值過 64 個 ASCII 字符。 |
返回參數
| 名稱 | 類型 | 描述 |
|---|---|---|
| VSwitchId | String | 係統分配的 VSwitchID |
錯誤碼
| 錯誤代碼 | 描述 | Http 狀態碼 | 語義 |
|---|---|---|---|
| InvalidZoneId.NotFound | Specified zone does not exist. | 404 | 指定的可用區不存在 |
| InvalidVpcId.NotFound | Specified VPC does not exist. | 404 | 指定的 VPC 不存在 |
| InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | 400 | 指定的 CIDR 格式不正確 |
| InvalidVSwitchName.Malformed | Specified virtual switch name is not valid. | 400 | 指定的 VSwitch 名字格式不正確 |
| InvalidVSwitchDiscription.Malformed | Specified virtual switch description is not valid. | 400 | 指定的 VSwitch 描述信息格式不正確 |
| ResourceNotAvailable | Resource you requested is not available in this region or zone. | 400 | 指定的 Region 或者可用區不支持 VPC |
| InvalidParameter | Specified CIDR block is not valid in VPC. | 400 | 指定的 CIDR 不正確 |
| InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other subnets. | 400 | 指定的 CIDR 與其他 VSwitch 的 CIDR 重疊 |
| InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other entry | 400 | 指定的 CIDR 與已有的自定義路由的 CIDR 重疊 |
| QuotaExceeded.VSwitch | Virtual switch quota exceeded. | 400 | VSwitch 數量達到配額上限 |
| IncorretRouteEntryStatus | Some route entry status blocked this operation. | 400 | 部分自定義路由處於 pending 狀態，創建 VSwitch 失敗 |
| IncorretVSwitchStatus | Some virtual switch is modifying within the same VPC. | 400 | 部分 VSwitch 處於 pending 狀態，創建 VSwitch 失敗 |
| InvalidCirdrBlock.MaskLength | Specified CIDR block is not valid. | 400 | 指定的 CIDR 網段格式不正確 |
| IncorrectVpcStatus | Current VPC status does not support this operation. | 400 | 指定的 VPC 處於 pending 狀態，創建 VSwitch 失敗 |
示例
請求示例
https://ecs.aliyuncs.com/?Action=CreateVSwitch&CidrBlock=172.16.1.0/24&VpcId=vpc-257gq642n&ZoneId=cn-beijing-a&<公共請求參數>
返回示例
XML格式
<CreateVSwitchResponse><RequestId>861E6630-AEC0-4B2D-B214-6CB5E44B7F04</RequestId><VSwitchId>vsw-25naue4gz</VSwitchId></CreateVSwitchResponse>
JSON格式
{"RequestId": "861E6630-AEC0-4B2D-B214-6CB5E44B7F04","VSwitchId": "vsw-25naue4gz"}
最後更新：2016-11-23 16:03:50
上一篇：
修改路由器屬性__路由器相關接口_API 參考_雲服務器 ECS-阿裏雲
下一篇： 刪除交換機__交換機相關接口_API 參考_雲服務器 ECS-阿裏雲
- UpdateRole__角色管理接口_RAM API文檔_訪問控製-阿裏雲
- 修改RDS實例訪問模式__實例管理_API 參考_雲數據庫 RDS 版-阿裏雲
- OSS轉儲授權__快速入門_歸檔存儲-阿裏雲
- 開源ShopNC安裝方法___安全問題_技術分享_雲虛機主機-阿裏雲
- 設置主題屬性__主題操作_快速入門_消息服務-阿裏雲
- 修改虛擬邊界路由器信息__高速通道相關接口_API 參考_雲服務器 ECS-阿裏雲
- 正則表達式規範__附錄_SQL_大數據計算服務-阿裏雲
- 消息發布與訂閱__最佳實踐_雲數據庫 Redis 版-阿裏雲
- 日誌庫__公共資源說明_API-Reference_日誌服務-阿裏雲
- 安裝前準備__快速開始_Eclipse 插件-阿裏雲
相關內容
- 常見錯誤說明__附錄_大數據計算服務-阿裏雲
- 發送短信接口__API使用手冊_短信服務-阿裏雲
- 接口文檔__Android_安全組件教程_移動安全-阿裏雲
- 運營商錯誤碼（聯通）__常見問題_短信服務-阿裏雲
- 設置短信模板__使用手冊_短信服務-阿裏雲
- OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
- 消息通知__操作指南_批量計算-阿裏雲
- 設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
- 查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
- 使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲