Creates a default vSwitch.
Operation description
When you call this operation, take note of the following limits:
-
The first IP address and last three IP addresses of a vSwitch CIDR block are reserved. For example, if the CIDR block of a vSwitch is 192.168.1.0/24, the IP addresses 192.168.1.0, 192.168.1.253, 192.168.1.254, and 192.168.1.255 are reserved.
-
The number of instances in the default vSwitch cannot exceed the remaining number of instances supported by the VPC (15,000 minus the number of existing instances).
-
Default vSwitches do not support multicasting or broadcasting.
-
After you create a default vSwitch, you cannot modify its CIDR block.
-
CreateDefaultVSwitch is an asynchronous operation. After you send a request, the system returns a request ID and runs the task in the background. You can call the DescribeVSwitchAttributes operation to query the status of a default vSwitch:
- If a default vSwitch is in the Pending state, it is being configured.
- If a default vSwitch is in the Available state, it is available.
-
If a default vSwitch already exists in a region, you cannot call this operation to create a default vSwitch in this region.
-
Before you create a default vSwitch, make sure that a default VPC is created. You can call the CreateDefaultVpc operation to create a default VPC.
Debugging
Authorization information
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action
policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level,
All Resources
is used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
Operation | Access level | Resource type | Condition key | Associated operation |
---|---|---|---|---|
vpc:CreateDefaultVSwitch |
|
| none |
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ZoneId | string | Yes | The zone ID of the default vSwitch. You can call the DescribeZones operation to query the most recent zone list. | cn-hangzhou-b |
RegionId | string | Yes | The region ID of the default vSwitch. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
Ipv6CidrBlock | integer | No | The last eight bits of the IPv6 CIDR block of the vSwitch. Valid values: 0 to 255. | 12 |
ClientToken | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters. Note
If you do not set this parameter, the system automatically uses the request ID as the client token. The request ID may be different for each request.
| 0c593ea1-3bea-11e9-b96b-88e9fe63**** |
Response parameters
Examples
Sample success responses
JSON
format
{
"VSwitchId": "vsw-bp1a4b5qhmxftjimq****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidDescription.Malformed | Invalid description. | - |
400 | InvalidVSwitchName.Malformed | Specified virtual switch name is not valid. | The format of the specified vSwitch name is invalid. Specify the name in the valid format. |
400 | InvalidVSwitchDiscription.Malformed | Specified virtual switch description is not valid. | The vSwitch description is invalid. |
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. | You cannot create a vSwitch in the current region or zone. |
400 | InvalidParameter | Specified CIDR block is not valid in VPC. | The CIDR block does not fall within the VPC CIDR block. |
400 | InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other subnets. | The vSwitch CIDR block overlaps with another vSwitch CIDR block or with the destination CIDR block of a custom route entry. Try a different CIDR block that is not in use. |
400 | InvalidCidrBlock.Overlapped | Specified CIDR block overlapped with other entry. | The specified CIDR block overlaps the CIDR block of another VPC or a custom routing destination. Select a CIDR block that is not used. |
400 | QuotaExceeded.VSwitch | Virtual switch quota exceeded. | The number of vSwitches has reached the upper limit. Reduce the number of vSwitches and try again later. |
400 | IncorrectRouteEntryStatus | Some route entry status blocked this operation. | The operation is not supported because the route table contains routes in the Pending or Modifying state. |
400 | IncorrectVSwitchStatus | Some virtual switch is modifying within the same VPC. | Multiple vSwitches are in the Modifying state in the same VPC. Try again later. |
400 | InvalidCirdrBlock.MaskLength | Specified CIDR block is not valid . | Invalid CIDR block. |
400 | IncorrectVpcStatus | Current VPC status does not support this operation. | This operation cannot be performed when the VPC is in the current state. |
400 | CreateVSwitch.IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | You cannot create a vSwitch when the CEN instance is in the current state. |
400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | The format of the CIDR block is invalid. |
400 | MissingParameter | Miss mandatory parameter. | Some required parameters are not specified. Specify all required parameters and try again. |
400 | IncorrectVSwitchStatus | VSwitch Creation simultaneously is not supported. | The system failed to create the vSwitch and one or more vSwitches that belong to the VPC are in the Creating state. |
400 | TaskConflict | The operation is too frequent, TaskConflict. | The system is unavailable. Try again later. |
400 | VPC.SWITCH.RULE.QUOTA.NOT.EXISTS | vSwitch quota rule not exists. | - |
400 | Forbidden.VpcNotFound | Specified VPC can not found. | The specified VPC does not exist. |
400 | RouteConflict.AlreadyExist | Route conflict exists in routing table. | Route conflicts exist in the route 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. | The status of the CEN instance is invalid. |
400 | OperationFailed.DefaultVpcNotExist | %s | - |
400 | UnsupportedFeature.CloudBoxIpv6 | The IPv6 feature is not supported by cloud box. | You cannot create an IPv6 address for a CloudBox instance. |
400 | OperationDenied.VpcPeerExist | The operation is not allowed because the VPC peer exists. | The operation failed because VPC peering connections exist. |
400 | OperationDenied.CenAttached | The operation is not allowed because the VPC is attached to CEN. | The operation is not allowed because the VPC is attached to a CEN instance. |
400 | OperationDenied.NatgwExist | The operation is not allowed because the NAT gateway exists in VPC. | The operation is not allowed because NAT gateways exist in the VPC. |
400 | OperationDenied.OtherSubnetCreating | other subnet is creating | - |
400 | OperationFailed.DefaultVSwitchExist | A default vSwitch already exists in the zone. | The error message returned because the default vSwitch already exists in the current zone. |
404 | Invalid.NotExist | witch mask rule not exists. | - |
404 | InvalidStatus.RouteEntry | RouteEntry status error. | - |
404 | InvalidZoneId.NotFound | Specified zone does not exist. | The zone ID is invalid. |
404 | InvalidVpcId.NotFound | Specified VPC does not exist. | The specified VPC does not exist. |
For a list of error codes, visit the Service error codes.