All Products
Search

This Product

    ENS:CreateVSwitch

    Document Center

    ENS:CreateVSwitch

    Last Updated:Mar 12, 2024

    Creates a vSwitch.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

    Authorization information

    There is currently no authorization information disclosed in the API.

    Request parameters

    ParameterTypeRequiredDescriptionExample
    EnsRegionIdstringYes

    The ID of the edge node.

    		cn-xian-unicom
    CidrBlockstringYes

    The CIDR block of the vSwitch. Take note of the following limits:

    • The subnet mask must be 16 to 29 bits in length.
    • The CIDR block of the vSwitch must fall within the CIDR block of the VPC to which the vSwitch belongs.
    • The CIDR block of the vSwitch cannot be the same as the destination CIDR block in a route entry of the VPC. However, it can be a subset of the destination CIDR block.
    		172.16.0.0/24
    VSwitchNamestringNo

    The name of the vSwitch. The name must meet the following requirements:

    • The name must be 2 to 128 characters in length.
    • The name must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).

    Default value: null.

    DescriptionstringNo

    The description of the vSwitch.

    The description must be 2 to 256 characters in length. It must start with a letter but cannot start with http:// or https://.

    		This is my vswitch.
    NetworkIdstringNo

    The ID of the network to which the vSwitch that you want to create belongs.

    		n-257gqcdfvx6n****

    Response parameters

    ParameterTypeDescriptionExample
    object
    VSwitchIdstring

    The ID of the vSwitch.

    		vsw-5****
    RequestIdstring

    The request ID.

    		CEF72CEB-54B6-4AE8-B225-F876FF7BA984

    Examples

    Sample success responses

    JSONformat

    {
  "VSwitchId": "vsw-5****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

    Error codes

    HTTP status codeError codeError messageDescription
    400MissingParameterThe input parameter that is mandatory for processing this request is not supplied.-
    400NoPermissionPermission denied.-
    400CallInterfaceCall Interface Happen Error.An error occurred when you call the operation.
    400InvalidParameter.%sThe specified field %s invalid. Please check it again.-
    400InvalidParameterThe errorMessage is %s. Please check it again.-
    400InvalidSecurityGroupId.NotFoundThe specified SecurityGroupId does not exist.-
    400SecurityGroupRuleConflict.DuplicatedThe SecurityGroup rule already exists.-
    400AuthorizationLimitExceedThe limit of authorization records in the security group reaches.-
    400ens.interface.errorAn error occurred while calling the API.-

    For a list of error codes, visit the Service error codes.

    Change history

    Change timeSummary of changesOperation
    No change history