Tüm Ürünler
Search

Bu Ürün

    :CreateVSwitch

    Belge Merkezi

    :CreateVSwitch

    Son Güncelleme:Oct 01, 2026

    Bir VSwitch oluşturur.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ens:CreateVSwitch

    create

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    EnsRegionId

    string

    Yes

    ENS düğümünün kimliği.

    cn-xian-unicom
    CidrBlock

    string

    Yes

    VSwitch'in CIDR bloğu. Aşağıdaki gereksinimler geçerlidir:

    • Ön ek uzunluğu 16 ile 29 arasında bir tam sayı olmalıdır.

    • VSwitch'in CIDR bloğu, VSwitch'in ait olduğu VPC'nin CIDR bloğunun bir alt kümesi olmalıdır.

    • VSwitch'in CIDR bloğu, VPC'deki mevcut bir yolun hedef CIDR bloğuyla aynı olamaz, ancak hedef CIDR bloğunun bir alt kümesi olabilir.

    172.16.0.0/24
    VSwitchName

    string

    No

    VSwitch'in adı. Aşağıdaki gereksinimler geçerlidir:

    • Ad 2 ila 128 karakter uzunluğunda olmalıdır.

    • Ad bir harf veya Çince karakterle başlamalıdır ve http:// veya https:// ile başlayamaz. Ad rakamlar, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.

    Varsayılan değer: boş dize.

    Test vSwitch
    Description

    string

    No

    VSwitch'in açıklaması.

    Açıklama 2 ila 256 karakter uzunluğunda olmalıdır. Bir harf veya Çince karakterle başlamalıdır ve http:// veya https:// ile başlayamaz.

    This is my vswitch.
    NetworkId

    string

    No

    VSwitch'in ait olduğu ağın kimliği.

    n-257gqcdfvx6n****
    Tag

    array<object>

    No

    Kaynağın etiketleri. En fazla 20 etiket belirtebilirsiniz.

    object

    No

    Bir kaynak etiketi.

    Key

    string

    No

    Etiketin anahtarı.

    • Etiket anahtarı aliyun, acs:, http:// veya https:// ile başlayamaz.

    • Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir.

    • Etiket anahtarı boş dize olamaz.

    team
    Value

    string

    No

    Etiketin değeri. En fazla 128 karakter uzunluğunda olabilir, boş dize olabilir ve acs: ile başlayamaz veya http:// ya da https:// içeremez.

    Deep
    Ipv6CidrBlock

    string

    No

    2408:XXXX:0:a600::/110

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt parametreleri.

    VSwitchId

    string

    VSwitch'in kimliği.

    vsw-5****
    RequestId

    string

    İstek kimliği.

    CEF72CEB-54B6-4AE8-B225-F876FF7BA984

    Examples

    Success response

    JSON format

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

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 NoPermission Permission denied.
    400 CallInterface Call Interface Happen Error. An error occurred when you call the operation.
    400 Invalid%s The specified parameter %s is invalid.
    400 Missing%s You must specify the parameter %s.
    400 NetworkNotFound The specified network is not found. Network not found, please check network id.
    400 IncorrectStatus.Network The status of the network is incorrect. The status of the network is incorrect.
    400 QuotaExceeded The number of resources has reached the quota limit. The number of resources has reached the quota limit.
    400 Network.SecondaryCidrNotFound The network secondary CIDR is not found.
    400 VSwitch.Ipv6CidrBlockOverlapped The specified IPv6 CIDR block overlaps with existing vSwitches.
    400 VSwitch.CidrBlockOverlapped The specified CIDR block overlaps with existing vswitches.
    400 VSwitch.InvalidIpv6CidrBlock Invalid IPv6 CIDR value.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.