全部產品
Search

搜尋本產品

    Virtual Private Cloud：CreateVSwitch

    文件中心

    Virtual Private Cloud：CreateVSwitch

    更新時間：Sep 04, 2026

    建立一個交換器。

    介面說明

    呼叫該介面建立交換器時，請注意以下事項：

    • 每個 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、127.0.0.0/8、169.254.0.0/16、224.0.0.0/4。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vpc:CreateVSwitch

    create

    *VPC

    acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

    *VSwitch

    acs:vpc:{#regionId}:{#accountId}:vswitch/*
    • vpc:tag
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Tag

    array<object>

    否

    資源的標籤。

    object

    否

    標籤。

    Key

    string

    否

    資源的標籤鍵。最多支援輸入 20 個標籤鍵。如需傳入該值，則不能輸入空字串。

    一個標籤鍵最多支援 128 個字元，不能以 aliyun 和 acs: 開頭，不能包含 http:// 或者 https://。

    FinanceJoshua
    Value

    string

    否

    資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入空字串。

    最多支援 128 個字元，不能以 aliyun 和 acs: 開頭，不能包含 http:// 或者 https://。

    FinanceDept
    ZoneId

    string

    是

    要建立的交換器所屬的可用區 ID。

    您可以透過呼叫 DescribeZones 介面取得可用區 ID。

    cn-hangzhou-b
    RegionId

    string

    否

    要建立的交換器的地域 ID。

    您可以透過呼叫 DescribeRegions 介面取得地域 ID。

    cn-hangzhou
    CidrBlock

    string

    否

    交換器的網段。交換器網段要求如下：

    • 交換器的網段的遮罩長度範圍為 16～29 位元。

    • 交換器的網段必須從屬於所在 VPC 的網段。

    • 交換器的網段不能與所在 VPC 中路由條目的目標網段相同，但可以是目標網段的子集。

    • 交換器的網段不能在以下保留位址範圍內：100.64.0.0/10、127.0.0.0/8、169.254.0.0/16、224.0.0.0/4。

    說明

    交換器建立成功後，無法修改網段。

    172.16.0.0/24
    CidrMask

    integer

    否

    交換器的 IPv4 網段遮罩。

    說明

    交換器 IPv4 網段的遮罩長度範圍為 16～29 位元。CidrBlock、CidrMask 至少輸入一個。

    24
    Ipv6CidrBlock

    integer

    否

    交換器 IPv6 網段的最後 8 個位元，取值：0～255。 僅交換器所屬 VPC 已啟用 IPv6 時，您可以傳入此參數為交換器分配 IPv6 網段。IPv6 網段分配後，無法修改為其他網段。需確保與所屬 VPC 下其他交換器的網段不重疊。

    12
    Ipv6CidrMask

    integer

    否

    交換器的 IPv6 網段遮罩。僅交換器所屬 VPC 已啟用 IPv6 時，您可以傳入此參數為交換器分配 IPv6 網段。

    說明

    僅支援 64。

    64
    VpcId

    string

    是

    要建立的交換器所屬的 VPC ID。

    vpc-257gqcdfvx6n****
    VSwitchName

    string

    否

    交換器的名稱。

    名稱長度為 1～128 個字元，不能以 http:// 或 https:// 開頭。

    vSwitch-1
    Description

    string

    否

    交換器的描述資訊。

    描述長度為 1～256 個字元，不能以 http:// 或 https:// 開頭。

    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.
    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 中有交換器的狀態為 Creating。
    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. EIP 操作太頻繁。
    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 閘道器。
    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. 網段不合法。
    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. 目前可用區已被停用，不允許建立交換器。
    400 OperationDenied.VpcIpv6CidrBlockNotExist The specified VpcIpv6CidrBlock does not exist in the VPC. 指定的 VpcIpv6CidrBlock 不存在於 VPC 中。
    400 OperationDenied.AvailableCidrInsufficient Insufficient available CIDR blocks for allocation. This is either because the VPC has no remaining address space, or because the candidate CIDR contains destination networks of active non-system routes in the VPC. 操作被拒絕，原因是可用的 CIDR 資源不足。
    400 OperationDenied.Ipv6CidrMaskInvalid The specified Ipv6CidrMask is invalid, only %s is allowed. 指定的 IPv6 遮罩無效，僅支援 %s。
    400 ParamExclusive.CidrBlockAndCidrMask CidrBlock and CidrMask are mutually exclusive. CidrBlock 和 CidrMask 參數互斥。
    400 MissingParam.Ipv6CidrBlockOrIpv6CidrMask Ipv6CidrBlock or Ipv6CidrMask must be specified. 必須至少指定 Ipv6CidrBlock 或 Ipv6CidrMask 其中一項。
    400 MissingParam.CidrBlockOrCidrMask CidrBlock or CidrMask is not specified. 新增位址區段至位址集區失敗，因為缺少位址區段或遮罩參數。
    400 UnsupportedFeature.Ipv6OnlyVsw IPv6-only VSwitches are not supported in this region.
    404 Invalid.NotExist witch mask rule not exists.
    404 InvalidVpcId.NotFound Specified VPC does not exist.

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

    變更歷史

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