CreateVSwitch - 创建交换机

创建交换机。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
EnsRegionIdstring

ENS 节点 ID。

cn-xian-unicom
CidrBlockstring

交换机的网段。交换机网段要求如下:

  • 交换机的网段的掩码长度范围为 16~29 位。
  • 交换机的网段必须从属于所在 VPC 的网段。
  • 交换机的网段不能与所在 VPC 中路由条目的目标网段相同,但可以是目标网段的子集。
172.16.0.0/24
VSwitchNamestring

交换机名称。命名规则如下:

  • 长度为 2~128 个英文或中文字符。
  • 必须以大小字母或中文开头,不能以 http://和 https://开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

默认值:空。

Test交换机
Descriptionstring

交换机的描述信息。

描述长度为 2~256 个字符,必须以字母或中文开头,但不能以 http://或 https://开头。

This is my vswitch.
NetworkIdstring

要创建的交换机所属的网络 ID。

n-257gqcdfvx6n****
Tagarray<object>

资源标签。

object

资源的标签。

Keystring

实例的标签键。N 的取值范围为 1~20

  • 不能以aliyunacs:http://https://开头。
  • 最多支持 64 个字符。
  • 不允许传入空字符串。
team
Valuestring

资源的标签值。N 的取值范围:1~20。一旦传入该值,可以为空字符串。最多支持 128 个字符,不能以 acs:开头,不能包含 http://或者 https://。

Deep

返回参数

名称类型描述示例值
object
VSwitchIdstring

交换机 ID。

vsw-5****
RequestIdstring

请求 ID。

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400MissingParameterThe input parameter that is mandatory for processing this request is not supplied.-
400NoPermissionPermission denied.没有足够的权限,请联系云账号管理员授予您相应权限。
400CallInterfaceCall Interface Happen Error.接口调用出错。
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.指定的安全组ID不存在。
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.-

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-09-12OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情