CreateVSwitch - 建立交換器
建立一個交換器。
介面說明
調用該介面建立交換器時，請注意以下事項：
-
每個 VPC 內的交換器數量不能超過 150 個。
-
每個交換器網段的第 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 減去當前雲產品執行個體數量）。
-
一個雲產品執行個體只能屬於一個交換器。
-
交換器不支援組播和廣播。
-
交換器建立成功後，無法修改網段。
-
CreateVSwitch 介面屬於非同步介面，即系統會返回一個執行個體 ID，但該交換器尚未建立完成，系統背景工作仍在進行中。您可以調用 DescribeVSwitchAttributes 查詢交換器的建立狀態：
當交換器處於 Pending 狀態時，表示交換器正在配置中。
當交換器處於 Available 狀態時，表示交換器可用。
-
CreateVSwitch 介面不支援在同一個 VPC 中並發建立交換器。
-
CreateVSwitch 介面不支援建立 100.64.0.0/10 及其子網網段的交換器。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Tag |
array<object> |
否 |
資源的標籤。 |
|
|
object |
否 |
標籤。 |
||
| Key |
string |
否 |
資源的標籤鍵。最多支援輸入 20 個標籤鍵。如需傳入該值，則不能輸入Null 字元串。 一個標籤鍵最多支援 128 個字元，不能以 |
FinanceJoshua |
| Value |
string |
否 |
資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入Null 字元串。 最多支援 128 個字元，不能以 |
FinanceDept |
| ZoneId |
string |
是 |
要建立的交換器所屬的可用性區域 ID。 您可以通過調用 DescribeZones 介面擷取可用性區域 ID。 |
cn-hangzhou-b |
| RegionId |
string |
否 |
要建立的交換器的地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-hangzhou |
| CidrBlock |
string |
是 |
交換器的網段。交換器網段要求如下：
說明
交換器建立成功後，無法修改網段。 |
172.16.0.0/24 |
| Ipv6CidrBlock |
integer |
否 |
交換器 IPv6 網段的最後 8 位元位，取值：0～255。 僅交換器所屬 VPC 已開啟 IPv6 時，您可以傳入此參數為交換器分配 IPv6 網段。IPv6 網段分配後，無法修改為其他網段。需確保與所屬 VPC 下其他交換器的網段不重疊。 |
12 |
| VpcId |
string |
是 |
要建立的交換器所屬的 VPC ID。 |
vpc-257gqcdfvx6n**** |
| VSwitchName |
string |
否 |
交換器的名稱。 名稱長度為 1～128 個字元，不能以 |
vSwitch-1 |
| Description |
string |
否 |
交換器的描述資訊。 描述長度為 1～256 個字元，不能以 |
vSwitch |
| ClientToken |
string |
否 |
用戶端 Token，用於保證請求的等冪性。 從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。 |
0c593ea1-3bea-11e9-b96b-88e9fe63**** |
| VpcIpv6CidrBlock |
string |
否 |
VPC 的 IPv6 網段。當交換器所屬 VPC 具有多個 IPv6 網段時，您可以傳入此參數指定交換器所屬的 IPv6 網段範圍。如不指定，將選擇 VPC 開啟 IPv6 時分配的 IPv6 網段。 |
2408:XXXX:0:6a::/56 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回資訊。 |
||
| VSwitchId |
string |
建立的交換器的 ID。 |
vsw-25navfgbue4g**** |
| RequestId |
string |
請求 ID。 |
0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
樣本
正常返回樣本
JSON格式
{
"VSwitchId": "vsw-25navfgbue4g****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | OperationFailed.ResourceConflict | vpc only support one cloud box. | |
| 400 | OperationFailed.IdempotentTokenProcessing | Action is processing. | |
| 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 | MissingParam.vpcId | The parameter vpcId is mandatory. | 參數缺失，vpcId是必選參數 |
| 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. | vSwitch數量達到配額上限，請您減少vSwitch數量後再試。 |
| 400 | IncorrectRouteEntryStatus | Some route entry status blocked this operation. | |
| 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. | |
| 400 | CreateVSwitch.IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | 當前CBN的狀態不支援建立虛擬交換器（VSwitch）操作 |
| 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. | 指定的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.NotifyCenCreate | Failed to notify cen when create vswitch. | |
| 400 | OperationFailed.DistibuteLock | Distibute lock fail. | 操作被其他請求加鎖； |
| 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 Gateway。 |
| 400 | MissingParam.Ipv6CidrBlock | The parameter Ipv6CidrBlock is mandatory. | 參數缺失，Ipv6CidrBlock是必選參數 |
| 400 | IllegalParam.VpcIpv6CidrBlock | %s | |
| 400 | OperationDenied.OtherSubnetCreating | The operation is not allowed because the other VSwitch is creating. | |
| 400 | OperationDenied.VpcPeerExists | The operation is not allowed because the VpcPeer exists. | 指定操作被禁止，因為VPC記憶體在VPC對等串連。 |
| 400 | IllegalParam.CidrBlock | The param of CidrBlock [%s] is illegal. | CidrBlock非法 |
| 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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。