创建EDS实例
接口功能介绍
异步接口，加载EDS网络实例, 可通过[查询EDS实例]中的实例状态字段判断加载是否完成。
接口约束
EDS实例只能加载到指定资源池下的云网关，具体资源池ID通过[查询资源池信息]接口获取。
URI
POST /v4/ec/eds-instance/create
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| ecID | 是 | String | 云间高速ID | 55450584-fe8f-49b0-9e09-ef915caeee10 | |
| cgwID | 是 | String | 云网关ID | bc9a70eb-28d7-4032-9510-1bea00192f34 | |
| 是 | String | 当前租户邮箱 | test@198.com | ||
| rtbID | 是 | String | 路由表ID | 70ebc9ab-28d7-4032-9510-1bea00192f34 | |
| vpcID | 是 | String | vpc实例ID | vpc-b3d4 | |
| vpcName | 是 | String | 云间高速侧显示的vpc的名称（建议保持和云桌面vpc创建时的名称一致） | vpc-test | |
| subnets | 是 | Array of Object | 子网列表 | [] | subnet |
| routeLearn | 否 | Integer | 路由学习开关，开启后云网关自动学习网络实例路由 取值范围: 1:学习 0:不学习 默认学习 |
1 | |
| routeSync | 否 | Integer | 路由同步开关，开启后云网关路由自动同步到网络实例 取值范围: 1:同步 0:不同步 默认同步 |
1 |
表 subnet
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| subnetName | 是 | String | 子网名称 | 165bc766 | |
| subnetID | 是 | String | 子网ID，填写错误会导致异步加载失败，导致回滚 | id-subnet | |
| IPVersion | 是 | String | 子网类型 取值范围: "IPV4":IPv4类型 |
||
| CIDR | 是 | String | 网络实例CIDR，当前仅支持v4子网 | 192.168.0.0/16 |
请求参数
请求头header参数
无
请求body参数
无
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 否 | Integer | 返回状态码 取值范围: 800:成功 900:失败 |
800 | |
| errorCode | 否 | String | 业务细分码，为product.module.code三段式码 | ||
| message | 否 | String | 失败时的错误描述，一般为英文描述 | ||
| description | 否 | String | 失败时的错误描述，一般为中文描述 | ||
| traceID | 否 | String | 链路追踪ID | 74cb2e66-1f95-45da-aac5-ee013470fd96 | |
| returnObj | 否 | Object | 返回参数 | returnObj |
表 returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| oplogID | 否 | String | 操作日志id | 66d1ad0b-a4c6-4fb8-80f5-0cb08943f49f |
请求示例
请求url
无
请求头header
无
请求体body
{
"ecID":"6949e4e6-8f92-4b05-8cae-b3977914f15b",
"cgwID": "ec505901-a16c-41fd-8ad0-33498ca4a235",
"rtbID": "1c2034a8-b1a8-4e97-9c0e-fa729e960fc7",
"email":"test@189.com",
"vpcID":"cb57bc09-8659-12d3-601a-e251f564ea68",
"vpcName":"cb57bc09",
"subnets": [{
"subnetID": "sub-sz-2",
"IPVersion": "IPV4",
"CIDR": "192.168.122.0/24",
"subnetName":"subnet1"
},
{
"subnetID": "sub-sz-1",
"IPVersion": "IPV6",
"CIDR": "2001:da8:201:1512::a269:83a0/128",
"subnetName":"subnet2"
}
],
"routeSync":1,
"routeLearn":1
}
响应示例
{
"description":"",
"errorCode":"",
"message":"",
"statusCode":800,
"traceID":"2062f2ab-6722-4273-9850-997b4398ddb5",
"returnObj": {
"oplogID": "66d1ad0b-a4c6-4fb8-80f5-0cb08943f49f"
}
}
状态码
| 状态码 | 含义 |
|---|---|
| 200 | 请求成功 |
错误码
| errorCode | 含义 |
|---|---|
| Openapi.PatternCheck.NotValid | 请求参数无效 |
| Openapi.NetworksEc.CreateError | 内部错误，请重试。如果多次尝试失败，请提交工单 |
