文档首页/ 密码安全中心 DEW/ API参考/ API说明/ 云平台密码系统服务/ 集群端口管理/ 创建集群模式端口
更新时间：2025-09-29 GMT+08:00
查看PDF
分享

创建集群模式端口

功能介绍

创建集群模式端口

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/dew/cpcs/cluster/{cluster_id}/port

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

cluster_id

是

String

集群ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户token，参见:IAM token获取方法
表3 请求Body参数

参数

是否必选

参数类型

描述

cluster_id

是

String

集群id

elb_id

是

String

elb id。端口映射将会在该elb中创建

mode

是

String

新增的端口的模式。除了VPN外，其他类型的服务只支持 PROXY

lb_listener_port

是

Integer

将在elb中为代理通道创建的监听器的端口

server_port

是

Integer

将在elb中为代理通道创建的后端服务组中后端服务器的端口。无默认值。

tunnel_lb_listener_port

否

Integer

将在elb中给VPN隧道创建的监听器的端口。当mode=TUNNEL时，必填

tunnel_server_port

否

Integer

将在elb中给VPN隧道创建的后端服务组中后端服务器的端口。

当mode=TUNNEL时，必填，有默认值:20706。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

id

String

uuid

cluster_id

String

该端口归属的集群id

elb_id

String

租户的elbId

elb_ip

String

租户的elb的ip

mode

String

PROXY：代理模式端口

TUNNEL：隧道模式自定端口

TUNNEL_FIXED：隧道模式的固定隧道端口

listener_port

Integer

elb监听端口

listener_id

String

elb监听器id

server_group_port

Integer

后端服务组绑定的后端服务器的业务端口

server_group_id

String

后端服务组id

project_id

String

项目id

validate_time

String

最后验证时间

wrong

Boolean

资源是否异常。

由于该接口功能是cpcs操作租户的elb。而租户是可以二次操作cpcs创建的端口映射的。cpcs提供了一个检测接口，用以检测cpcs创建的这一套监听端口是否有误。

wrong_msg

String

若端口有误。即wrong=true时。该字段描述错误的地方

请求示例

无

响应示例

状态码：200

请求已成功

{
  "id" : "string",
  "cluster_id" : "string",
  "elb_id" : "string",
  "elb_ip" : "string",
  "mode" : "PROXY",
  "listener_port" : 0,
  "listener_id" : "string",
  "server_group_port" : 0,
  "server_group_id" : "string",
  "project_id" : "string",
  "validate_time" : "string",
  "wrong" : true,
  "wrong_msg" : "后端服务组中后端服务器的数量不对"
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 集群端口管理

相关文档