新建K8s应用实例service
更新时间 2026-07-10 14:05:42
最近更新时间: 2026-07-10 14:05:42
接口功能介绍
调用addK8sService接口新建K8s应用实例service
接口约束
无
URI
POST /v2/app/inst/addK8sService
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID，请参考调用前必知-概述 | bb9fdb42056f11eda1610242ac110002 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| appDeployUuid | 是 | String | 应用实例uuid | ||
| name | 是 | String | K8s service名称，请输入以小写字母开头，小写字母、数字、中划线组成的1到32字符的字符串 | ||
| type | 是 | String | 服务类型，仅支持ClusterIP和NodePort | ||
| trafficPolicy | 否 | String | K8s service路由策略仅支持Local和Cluster，type为NodePort时必填 | ||
| headless | 否 | Boolean | 实例间服务发现 | ||
| servicesPorts | 是 | Array of Objects | K8s Service端口映射列表 | servicesPorts |
表 servicesPorts
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| protocol | 是 | String | 服务协议，支持TCP和UDP | ||
| port | 是 | Integer | 服务端口，最小值为1，最大值为65535 | ||
| targetPort | 是 | Integer | 容器端口，最小值为1，最大值为65535 | ||
| nodePort | 否 | Integer | 节点端口，最小值为30000，最大值为32767，type为NodePort时必填，具体范围取决于所在CCE集群 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应编码 2000 success | ||
| message | String | 消息内容 | ||
| returnObj | Object | 返回数据 | returnObj | |
| error | String | 调用错误时返回的错误编码 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| changeUuid | String | 变更记录uuid |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"appDeployUuid": "1b313891edc3465d9ab2151955b7642a",
"name": "test",
"type": "NodePort",
"trafficPolicy": "Local",
"servicesPorts": [
{
"protocol": "TCP",
"port": 48080,
"targetPort": 18080,
"nodePort": 30000
}
]
}
响应示例
{
"statusCode": 2000,
"message": "成功",
"returnObj": {
"changeUuid": "c8350072faf044dcbcc0c3f6d36ed6f5"
}
}
状态码
请参考 状态码
错误码
请参考 错误码
