CreateDefaultVSwitch

呼叫 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

create

*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****

返回參數

名稱	類型	描述	樣本值
	object	建立的預設交換機的 ID。
VSwitchId	string	建立的預設交換機的 ID。	vsw-bp1a4b5qhmxftjimq****
RequestId	string	請求 ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

樣本

正常返回樣本

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.
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.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other subnets.
400	QuotaExceeded.VSwitch	Virtual switch quota exceeded.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	MissingParameter	Miss mandatory parameter.
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.
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.
400	OperationFailed.DefaultVpcNotExist	%s
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.
400	OperationDenied.OtherSubnetCreating	other subnet is creating
400	OperationFailed.DefaultVSwitchExist	A default vSwitch already exists in the zone.
400	InvalidStatus.RouteEntry	RouteEntry status error.
400	InvalidZoneId.NotFound	Specified zone does not exist.
400	OperationDenied.ZoneIsDisabled	The specified zone is disabled. You cannot create a vSwitch in a disabled zone.
404	Invalid.NotExist	witch mask rule not exists.
404	InvalidVpcId.NotFound	Specified VPC does not exist.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。