創(chuàng)建一個(gè)交換機(jī)。
接口說(shuō)明
調(diào)用該接口創(chuàng)建交換機(jī)時(shí)，請(qǐng)注意以下事項(xiàng)：
-
每個(gè) VPC 內(nèi)的交換機(jī)數(shù)量不能超過(guò) 150 個(gè)。
-
每個(gè)交換機(jī)網(wǎng)段的第 1 個(gè)和最后 3 個(gè) IP 地址為系統(tǒng)保留地址。例如 192.168.1.0/24 的系統(tǒng)保留地址為 192.168.1.0、192.168.1.253、192.168.1.254 和 192.168.1.255。
-
交換機(jī)下的云產(chǎn)品實(shí)例數(shù)量不允許超過(guò) VPC 剩余的可用云產(chǎn)品實(shí)例數(shù)量（15000 減去當(dāng)前云產(chǎn)品實(shí)例數(shù)量）。
-
一個(gè)云產(chǎn)品實(shí)例只能屬于一個(gè)交換機(jī)。
-
交換機(jī)不支持組播和廣播。
-
交換機(jī)創(chuàng)建成功后，無(wú)法修改網(wǎng)段。
-
CreateVSwitch 接口屬于異步接口，即系統(tǒng)會(huì)返回一個(gè)實(shí)例 ID，但該交換機(jī)尚未創(chuàng)建完成，系統(tǒng)后臺(tái)任務(wù)仍在進(jìn)行中。您可以調(diào)用 DescribeVSwitchAttributes 查詢交換機(jī)的創(chuàng)建狀態(tài)：
- 當(dāng)交換機(jī)處于 Pending 狀態(tài)時(shí)，表示交換機(jī)正在配置中。
- 當(dāng)交換機(jī)處于 Available 狀態(tài)時(shí)，表示交換機(jī)可用。
-
CreateVSwitch 接口不支持在同一個(gè) VPC 中并發(fā)創(chuàng)建交換機(jī)。
-
CreateVSwitch 接口不支持創(chuàng)建 100.64.0.0/10 及其子網(wǎng)網(wǎng)段的交換機(jī)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語(yǔ)句的Action元素中使用，用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問(wèn)級(jí)別：是指每個(gè)操作的訪問(wèn)級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說(shuō)明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問(wèn)級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| vpc:CreateVSwitch | create | *VPC acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}*VSwitch acs:vpc:{#regionId}:{#accountId}:vswitch/* |
| 無(wú) |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Tag | array<object> | 否 | 資源的標(biāo)簽。 | |
| object | 否 | 標(biāo)簽。 | ||
| Key | string | 否 | 資源的標(biāo)簽鍵。最多支持輸入 20 個(gè)標(biāo)簽鍵。如需傳入該值，則不能輸入空字符串。 一個(gè)標(biāo)簽鍵最多支持 128 個(gè)字符，不能以 | FinanceJoshua |
| Value | string | 否 | 資源的標(biāo)簽值。最多支持輸入 20 個(gè)標(biāo)簽值。如需傳入該值，可以輸入空字符串。 最多支持 128 個(gè)字符，不能以 | FinanceDept |
| ZoneId | string | 是 | 要?jiǎng)?chuàng)建的交換機(jī)所屬的可用區(qū) ID。 您可以通過(guò)調(diào)用 DescribeZones 接口獲取可用區(qū) ID。 | cn-hangzhou-b |
| RegionId | string | 否 | 要?jiǎng)?chuàng)建的交換機(jī)的地域 ID。 您可以通過(guò)調(diào)用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
| CidrBlock | string | 是 | 交換機(jī)的網(wǎng)段。交換機(jī)網(wǎng)段要求如下：
| 172.16.0.0/24 |
| Ipv6CidrBlock | integer | 否 | 交換機(jī) IPv6 網(wǎng)段的最后 8 比特位，取值：0～255。 | 12 |
| VpcId | string | 是 | 要?jiǎng)?chuàng)建的交換機(jī)所屬的 VPC ID。 | vpc-257gqcdfvx6n**** |
| VSwitchName | string | 否 | 交換機(jī)的名稱。 名稱長(zhǎng)度為 1～128 個(gè)字符，不能以 | vSwitch-1 |
| Description | string | 否 | 交換機(jī)的描述信息。 描述長(zhǎng)度為 1～256 個(gè)字符，不能以 | vSwitch |
| ClientToken | string | 否 | 客戶端 Token，用于保證請(qǐng)求的冪等性。 從您的客戶端生成一個(gè)參數(shù)值，確保不同請(qǐng)求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符。 說(shuō)明
若您未指定，則系統(tǒng)自動(dòng)使用 API 請(qǐng)求的 RequestId 作為 ClientToken 標(biāo)識(shí)。每次 API 請(qǐng)求的 RequestId 可能不一樣。
| 0c593ea1-3bea-11e9-b96b-88e9fe63**** |
| VpcIpv6CidrBlock | string | 否 | VPC 的 IPv6 網(wǎng)段。 | 2408:XXXX:0:6a::/56 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"VSwitchId": "vsw-25navfgbue4g****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 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名字格式不正確，請(qǐng)您確認(rèn)vSwitch名字格式。 |
| 400 | InvalidVSwitchDiscription.Malformed | Specified virtual switch description is not valid. | 交換機(jī)描述不合法。 |
| 400 | Abs.Vpc.InvalidDescription.Malformed | Specified virtual switch name is not valid. | - |
| 400 | MissingParam.vpcId | The parameter vpcId is mandatory. | 參數(shù)缺失，vpcId是必選參數(shù) |
| 400 | ResourceNotAvailable | Resource you requested is not available in this region or zone. | 當(dāng)前地域或可用區(qū)不支持創(chuàng)建交換機(jī)。 |
| 400 | InvalidParameter | Specified CIDR block is not valid in VPC. | 該網(wǎng)段不在VPC網(wǎng)段內(nèi)。 |
| 400 | InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other subnets. | 該交換機(jī)網(wǎng)段與其他交換機(jī)的網(wǎng)段重疊或與已有的自定義路由的目標(biāo)網(wǎng)段重疊，請(qǐng)使用其他未被占用的網(wǎng)段。 |
| 400 | InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other entry. | 該交換機(jī)網(wǎng)段與其他交換機(jī)的網(wǎng)段重疊或與已有的自定義路由的目標(biāo)網(wǎng)段重疊，請(qǐng)使用其他未被占用的網(wǎng)段。 |
| 400 | QuotaExceeded.VSwitch | Virtual switch quota exceeded. | vSwitch數(shù)量達(dá)到配額上限，請(qǐng)您減少vSwitch數(shù)量后再試。 |
| 400 | IncorrectRouteEntryStatus | Some route entry status blocked this operation. | 無(wú)法執(zhí)行該操作，當(dāng)前路由表中有路由條目的狀態(tài)為pending或modifying。 |
| 400 | IncorrectVSwitchStatus | Some virtual switch is modifying within the same VPC. | 同一個(gè)VPC下存在多個(gè)“修改中”的虛擬交換機(jī)，請(qǐng)您稍后重試。 |
| 400 | InvalidCirdrBlock.MaskLength | Specified CIDR block is not valid . | 該CIDR網(wǎng)段格式不正確。 |
| 400 | IncorrectVpcStatus | Current VPC status does not support this operation. | 當(dāng)前VPC的狀態(tài)無(wú)法支持這個(gè)操作。 |
| 400 | CreateVSwitch.IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | 當(dāng)前CBN的狀態(tài)不支持創(chuàng)建虛擬交換機(jī)（VSwitch）操作 |
| 400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | 該CIDR格式不正確。 |
| 400 | MissingParameter | Miss mandatory parameter. | 缺少必要參數(shù)，請(qǐng)您檢查必填參數(shù)是否都已填后再進(jìn)行操作。 |
| 400 | IncorrectVSwitchStatus | VSwitch Creation simultaneously is not supported. | 創(chuàng)建交換機(jī)失敗，VPC中有交換機(jī)的狀態(tài)為Creating。 |
| 400 | TaskConflict | The operation is too frequent, TaskConflict. | 操作太頻繁，請(qǐng)稍后重試 |
| 400 | VPC.SWITCH.RULE.QUOTA.NOT.EXISTS | vSwitch quota rule not exists. | - |
| 400 | Forbidden.VpcNotFound | Specified VPC can not found. | 指定的VPC不存在，請(qǐng)您檢查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當(dāng)前狀態(tài)不正確 |
| 400 | OperationFailed.NotifyCenCreate | Failed to notify cen when create vswitch. | - |
| 400 | OperationFailed.DistibuteLock | Distibute lock fail. | 操作被其他請(qǐng)求加鎖； |
| 400 | UnsupportedFeature.CloudBoxIpv6 | The IPv6 feature is not supported by cloud box. | 云盒不支持創(chuàng)建IPv6。 |
| 400 | OperationDenied.VpcPeerExist | The operation is not allowed because the VPC peer exists. | 指定操作被禁止，因?yàn)閂PC存在對(duì)等連接。 |
| 400 | OperationDenied.CenAttached | The operation is not allowed because the VPC is attached to CEN. | 指定操作被禁止，因?yàn)閂PC關(guān)聯(lián)了CEN。 |
| 400 | OperationDenied.NatgwExist | The operation is not allowed because the NAT gateway exists in VPC. | 指定操作被禁止，因?yàn)閂PC中創(chuàng)建有NAT網(wǎng)關(guān)。 |
| 400 | MissingParam.Ipv6CidrBlock | The parameter Ipv6CidrBlock is mandatory. | 參數(shù)缺失，Ipv6CidrBlock是必選參數(shù) |
| 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. | 指定操作被禁止，因?yàn)閂PC內(nèi)存在VPC對(duì)等連接。 |
| 400 | IllegalParam.CidrBlock | The param of CidrBlock [%s] is illegal. | CidrBlock非法 |
| 404 | Invalid.NotExist | witch mask rule not exists. | - |
| 404 | InvalidStatus.RouteEntry | RouteEntry status error. | - |
| 404 | InvalidZoneId.NotFound | Specified zone does not exist. | 可用區(qū)ID不正確。 |
| 404 | InvalidVpcId.NotFound | Specified VPC does not exist. | 該VPC不存在。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-01-17 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-09-06 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-07-05 | OpenAPI 描述信息更新、OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |