1)接口功能介绍
创建虚拟交换机。
2)接口约束
必须确保新建虚拟交换机网段与所属私有网络处于同一网段下且虚拟交换机网段没有冲突。
3)URI
POST /v1/createVSwitch。
4)请求参数
请求体body参数
参数名称 | 是否必须 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
vSwitchInfos | 是 | ArrayObject | 需要创建的虚拟交换机信息列表 | vSwitchInfos | |
vpcId | 是 | String | 私有网络id | 1142 |
表 vSwitchInfos
参数名称 | 是否必须 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
cidrBlock | 是 | String | 虚拟交换机IPv4网段,格式为a.b.c.d/y,如192.168.0.0/16 cidrBlock必须是VPC网段vpcSubnet的子网 | 192.168.0.0/16 | |
vSwitchName | 是 | String | 虚拟交换机名称 | eop-switch |
5)响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
requestId | 是 | String | 请求id | b84233d3-0796-xxx | |
status | 是 | Object | 应答状态 | status | |
data | 是 | Object | 返回数据 | data |
表 status
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
message | 是 | String | 状态描述 | Success | |
code | 是 | String | 状态码 | Success |
表 data
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
vSwitchIds | 是 | List | 虚拟交换机id列表 | ["1430"] |
6)请求示例
请求体body
{
"vpcId": "1142",
"vSwitchInfos": [
{
"vSwitchName": "eop-switch",
"cidrBlock": "10.1.0.0/24"
}
]
}
7)响应示例
{
"status": {
"message": "Success",
"code": "Success"
},
"data": {
"vSwitchIds": [
"1430"
]
},
"requestId": "2bb95391-b7bb-47a5-a283-fa920985560f"
}
8)状态码
状态码 | 描述 |
---|---|
Success | 表示请求成功。 |