创建一个虚拟节点
更新时间 2025-11-21 09:57:54
最近更新时间: 2025-11-21 09:57:54
接口功能介绍
调用该接口创建一个虚拟节点
接口约束
无
URI
POST /eci/api/v1/virtualNode/createVirtualNode
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 区域ID | bb9fdb42056f11eda1610242ac110002 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| vpcId | 是 | String | 虚拟节点所在Vpc ID | vpc-ctt6yag121 | |
| vSwitchId | 是 | String | 虚拟节点所在的子网ID | subnet-y9n723knrg | |
| securityGroupId | 是 | String | 虚拟节点所在的安全组ID | sg-5bvqyvrmch | |
| azInfo | 是 | Array of Objects | 区域信息 | azInfo | |
| virtualNodeName | 否 | String | 虚拟节点名称 | test | |
| kubeConfig | 是 | String | 虚拟节点要连接的 K8s 集群的 KubeConfig。需进行 Base64 编码 | YXBpdmVyc2lvb*** | |
| tags | 否 | Array of Objects | 标签 | tag | |
| taints | 否 | Array of Objects | 污点 | taint | |
| 表 azInfo |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| azName | 是 | String | 区域AZ 名称,目前仅支持一个 | cn-huadong1-jsnj1A-public-ctcloud | |
| 表 tag |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| key | 否 | String | 标签的key | key-test | |
| value | 否 | String | 标签的value | value-test | |
| 表 taint |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| key | 否 | String | 污点的key | key-test | |
| value | 否 | String | 污点的value | value-test | |
| effect | 否 | String | 污点的effect,取值范围: NoSchedule:不将 Pod 调度到具有该污点的节点上。 NoExecute:不将 Pod 调度到具有该污点的节点上的同时,驱逐节点上已经存在的 Pod。 PreferNoSchedule:尽量不将 Pod 调度到具有该污点的节点上。 | NoSchedule |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 请求成功(200)或失败(非200) | 200 | |
| error | String | 错误码,三段式 | ECI.Openapi.StatusReasonInternalError | |
| message | String | 错误信息描述 | Internal error occurred | |
| returnObj | Object | 返回信息 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| virtualNodeId | String | 虚拟节点ID | vnd-k511b21gto5mfytt | |
| requestId | String | 请求ID | b0a55967-825e-4037-a1e2-c1320485 |
枚举参数
无
请求示例
请求url
https://eci-global.ctapi.ctyun.cn/eci/api/v1/virtualNode/createVirtualNode
请求头header
{
regionId:bb9fdb42056f11eda1610242ac110002
}
请求体body
{
"azInfo": [
{
"azId": 1,
"azName": "cn-xinan1-1A"
}
],
"kubeConfig": "YXBpdmVyc2lvbjogdj*****",
"securityGroupId": "sg-qa5ajphdq1",
"tags": [
{
"key": "key-test",
"value": "kley-value"
}
],
"taints": [
{
"key": "key-test",
"value": "key-value",
"effect": "NoSchedule"
}
],
"vSwitchId": "subnet-ol9wtzdtlc",
"virtualNodeName": "test",
"vpcId": "vpc-hfimen7syc"
}
响应示例
{
"statusCode": 200,
"returnObj": {
"requestId": "6c9ade46-e887-437c-b1e3-39fd080ad1dd",
"virtualNodeId": "vnd-k511b21gto5mfytt"
}
}
状态码
请参考 状态码
错误码
请参考 错误码