調用CreateDefaultVSwitch接口創建一個默認的交換機。
接口說明
調用該接口創建默認交換機時，請注意以下事項：
-
每個默認交換機網段的第 1 個和最后 3 個 IP 地址為系統保留地址。例如 192.168.1.0/24 的系統保留地址為 192.168.1.0、192.168.1.253、192.168.1.254 和 192.168.1.255。
-
默認交換機下的云產品實例數量不允許超過 VPC 剩余的可用云產品實例數量（15000 減去當前云產品實例數量）。
-
默認交換機不支持組播和廣播。
-
默認交換機創建成功后，無法修改網段。
-
CreateDefaultVSwitch 接口屬于異步接口，即系統會返回一個實例 ID，但該默認交換機尚未創建完成，系統后臺任務仍在進行中。您可以調用 DescribeVSwitchAttributes 查詢默認交換機的創建狀態：
- 當默認交換機處于 Pending 狀態時，表示默認交換機正在配置中。
- 當默認交換機處于 Available 狀態時，表示默認交換機可用。
-
當指定地域的可用區已有默認交換機時，調用該接口創建默認交換機會失敗。
-
創建默認交換機時，需要先創建一個默認 VPC。您可以通過調用 CreateDefaultVpc 接口創建默認 VPC。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:CreateDefaultVSwitch | *VSwitch acs:vpc:{#regionid}:{#accountId}:vswitch/* |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ZoneId | string | 是 | 要創建的默認交換機所屬的可用區 ID。 您可以通過調用 DescribeZones 接口獲取可用區 ID。 | cn-hangzhou-b |
| RegionId | string | 是 | 要創建的默認交換機的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
| Ipv6CidrBlock | integer | 否 | 交換機 IPv6 網段的最后 8 比特位，取值：0～255。 | 12 |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 0c593ea1-3bea-11e9-b96b-88e9fe63**** |
返回參數
示例
正常返回示例
JSON格式
{
"VSwitchId": "vsw-bp1a4b5qhmxftjimq****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidDescription.Malformed | Invalid description. | - |
| 400 | InvalidVSwitchName.Malformed | Specified virtual switch name is not valid. | 該vSwitch名字格式不正確，請您確認vSwitch名字格式。 |
| 400 | InvalidVSwitchDiscription.Malformed | Specified virtual switch description is not valid. | 交換機描述不合法。 |
| 400 | Abs.Vpc.InvalidDescription.Malformed | Specified virtual switch name is not valid. | - |
| 400 | ResourceNotAvailable | Resource you requested is not available in this region or zone. | 當前地域或可用區不支持創建交換機。 |
| 400 | InvalidParameter | Specified CIDR block is not valid in VPC. | 該網段不在VPC網段內。 |
| 400 | InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other subnets. | 該交換機網段與其他交換機的網段重疊或與已有的自定義路由的目標網段重疊，請使用其他未被占用的網段。 |
| 400 | InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other entry. | 該交換機網段與其他交換機的網段重疊或與已有的自定義路由的目標網段重疊，請使用其他未被占用的網段。 |
| 400 | QuotaExceeded.VSwitch | Virtual switch quota exceeded. | vSwitch數量達到配額上限，請您減少vSwitch數量后再試。 |
| 400 | IncorrectRouteEntryStatus | Some route entry status blocked this operation. | 無法執行該操作，當前路由表中有路由條目的狀態為pending或modifying。 |
| 400 | IncorrectVSwitchStatus | Some virtual switch is modifying within the same VPC. | 同一個VPC下存在多個“修改中”的虛擬交換機，請您稍后重試。 |
| 400 | InvalidCirdrBlock.MaskLength | Specified CIDR block is not valid . | 該CIDR網段格式不正確。 |
| 400 | IncorrectVpcStatus | Current VPC status does not support this operation. | 當前VPC的狀態無法支持這個操作。 |
| 400 | CreateVSwitch.IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | 當前CBN的狀態不支持創建虛擬交換機（VSwitch）操作 |
| 400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | 該CIDR格式不正確。 |
| 400 | MissingParameter | Miss mandatory parameter. | 缺少必要參數，請您檢查必填參數是否都已填后再進行操作。 |
| 400 | IncorrectVSwitchStatus | VSwitch Creation simultaneously is not supported. | 創建交換機失敗，VPC中有交換機的狀態為Creating。 |
| 400 | TaskConflict | The operation is too frequent, TaskConflict. | 操作太頻繁，請稍后重試 |
| 400 | VPC.SWITCH.RULE.QUOTA.NOT.EXISTS | vSwitch quota rule not exists. | - |
| 400 | Forbidden.VpcNotFound | Specified VPC can not found. | 指定的VPC不存在，請您檢查VPC是否正確。 |
| 400 | RouteConflict.AlreadyExist | Route conflict exists in routing table. | 路由表中存在路由沖突。 |
| 400 | OperationFailed.CidrAcross | Classic link instance cidr must not across. | - |
| 400 | Duplicated.ClientToken | %s | - |
| 400 | OperationFailed.Ipv6CidrBlockExisted | %s | - |
| 400 | IllegalParam.Ipv6CidrBlock | %s | - |
| 400 | OperationFailed.VpcIpv6Disabled | %s | - |
| 400 | IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | CBN當前狀態不正確 |
| 400 | OperationFailed.DefaultVpcNotExist | %s | - |
| 400 | UnsupportedFeature.CloudBoxIpv6 | The IPv6 feature is not supported by cloud box. | 云盒不支持創建IPv6。 |
| 400 | OperationDenied.VpcPeerExist | The operation is not allowed because the VPC peer exists. | 指定操作被禁止，因為VPC存在對等連接。 |
| 400 | OperationDenied.CenAttached | The operation is not allowed because the VPC is attached to CEN. | 指定操作被禁止，因為VPC關聯了CEN。 |
| 400 | OperationDenied.NatgwExist | The operation is not allowed because the NAT gateway exists in VPC. | 指定操作被禁止，因為VPC中創建有NAT網關。 |
| 400 | OperationDenied.OtherSubnetCreating | other subnet is creating | - |
| 400 | OperationFailed.DefaultVSwitchExist | A default vSwitch already exists in the zone. | 當前可用區已經存在默認交換機。 |
| 404 | Invalid.NotExist | witch mask rule not exists. | - |
| 404 | InvalidStatus.RouteEntry | RouteEntry status error. | - |
| 404 | InvalidZoneId.NotFound | Specified zone does not exist. | 可用區ID不正確。 |
| 404 | InvalidVpcId.NotFound | Specified VPC does not exist. | 該VPC不存在。 |
訪問錯誤中心查看更多錯誤碼。