调用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减去当前云产品实例数量)。
- 一个云产品实例只能属于一个交换机。
- 交换机不支持组播和广播。
- 交换机创建成功后,无法修改网段。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateVSwitch |
系统规定参数。取值:CreateVSwitch。 |
ZoneId | String | 是 | cn-hangzhou-b |
要创建的交换机所属的可用区ID。您可以通过调用DescribeZones接口获取可用区ID。 |
RegionId | String | 否 | cn-hangzhou |
要创建的交换机的地域ID。您可以通过调用DescribeRegions接口获取地域ID。 |
CidrBlock | String | 是 | 172.16.0.0/24 |
交换机的网段。交换机网段要求如下:
|
Ipv6CidrBlock | Integer | 否 | 12 |
交换机IPv6网段的最后8比特位,取值:0~255。 |
VpcId | String | 是 | vpc-257gqcdfvx6n**** |
要创建的交换机所属的VPC ID。 |
VSwitchName | String | 否 | vSwitch-1 |
交换机的名称。 名称长度为2~128个字符,以英文字母或中文开头,可包含数字、下划线(_)和短划线(-)。 |
Description | String | 否 | vSwitch |
交换机的描述信息。 描述可以为空,或输入2~256个中英文字符,不能以http://和https://开头。 |
ClientToken | String | 否 | 0c593ea1-3bea-11e9-b96b-88e9fe63**** |
客户端Token,用于保证请求的幂等性。 由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符。 说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
|
VpcIpv6CidrBlock | String | 否 | 2408:XXXX:0:6a::/56 |
VPC的IPv6网段。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
VSwitchId | String | vsw-25navfgbue4g**** |
创建的交换机的ID。 |
RequestId | String | 0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
请求ID。 |
示例
请求示例
http(s)://vpc.aliyuncs.com/?Action=CreateVSwitch
&CidrBlock=172.16.0.0/24
&VpcId=vpc-257gqcdfvx6n****
&ZoneId=cn-hangzhou-b
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateVSwitchResponse>
<RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
<VSwitchId>vsw-25naue4cdvf****</VSwitchId>
</CreateVSwitchResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
"VSwitchId" : "vsw-25naue4cdvf****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidVSwitchName.Malformed | Specified virtual switch name is not valid. | 该vSwitch名字格式不正确,请您确认vSwitch名字格式。 |
400 | InvalidVSwitchDiscription.Malformed | Specified virtual switch description 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 | 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 | Forbidden.VpcNotFound | Specified VPC can not found. | 指定的VPC不存在,请您检查VPC是否正确。 |
400 | RouteConflict.AlreadyExist | Route conflict exists in routing table. | 路由表中存在路由冲突。 |
400 | IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | CBN当前状态不正确 |
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网关。 |
404 | InvalidZoneId.NotFound | Specified zone does not exist. | 可用区ID不正确。 |
404 | InvalidVpcId.NotFound | Specified VPC does not exist. | 该VPC不存在。 |
访问错误中心查看更多错误码。