创建交换机。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ens:CreateVSwitch |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnsRegionId |
string |
是 |
ENS 节点 ID。 |
cn-xian-unicom |
| CidrBlock |
string |
是 |
交换机的网段。交换机网段要求如下：
|
172.16.0.0/24 |
| VSwitchName |
string |
否 |
交换机名称。命名规则如下：
默认值：空。 |
Test vSwitch |
| Description |
string |
否 |
交换机的描述信息。 描述长度为 2~256 个字符，必须以字母或中文开头，但不能以 http://或 https://开头。 |
This is my vswitch. |
| NetworkId |
string |
否 |
要创建的交换机所属的网络 ID。 |
n-257gqcdfvx6n**** |
| Tag |
array<object> |
否 |
资源标签。 |
|
|
object |
否 |
资源的标签。 |
||
| Key |
string |
否 |
实例的标签键。N 的取值范围为 1~20。
|
team |
| Value |
string |
否 |
资源的标签值。N 的取值范围：1~20。一旦传入该值，可以为空字符串。最多支持 128 个字符，不能以 acs:开头，不能包含 http://或者 https://。 |
Deep |
| Ipv6CidrBlock |
string |
否 |
2408:XXXX:0:a600::/110 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| VSwitchId |
string |
交换机 ID。 |
vsw-5**** |
| RequestId |
string |
请求 ID。 |
CEF72CEB-54B6-4AE8-B225-F876FF7BA984 |
示例
正常返回示例
JSON格式
{
"VSwitchId": "vsw-5****",
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | NoPermission | Permission denied. | |
| 400 | CallInterface | Call Interface Happen Error. | 接口调用出错。 |
| 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. | 找不到网络，请检查网络id。 |
| 400 | IncorrectStatus.Network | The status of the network is incorrect. | 网络的状态不正确。 |
| 400 | QuotaExceeded | 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. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。