租户端 互联网中间件 微服务框架（TSF） 部署组相关接口 CreateContainGroup

CreateContainGroup

最近更新时间: 2025-10-20 17:06:15

1. 接口描述

接口请求域名： tsf.api3.fincloud.tencent.cn。

创建容器部署组

默认接口请求频率限制：20次/秒。

接口更新时间：2020-04-07 10:59:52。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：CreateContainGroup
Version 是 否 String 公共参数，本接口取值：2018-03-26
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
ApplicationId 是 否 String 分组所属应用ID
NamespaceId 是 否 String 分组所属命名空间ID
GroupName 是 否 String 分组名称字段，长度1~60，字母或下划线开头，可包含字母数字下划线
CpuLimit 否 否 String 最大分配 CPU 核数，对应 K8S limit
MemLimit 否 否 String 最大分配内存 MiB 数，对应 K8S limit
InstanceNum 是 否 Int64 实例数量
AccessType 是 否 Int64 0:公网 1:集群内访问 2：NodePort
ProtocolPorts 是 否 Array of ProtocolPort 数组对象，见下方定义
GroupComment 否 否 String 分组备注字段，长度应不大于200字符
UpdateType 否 否 Int64 更新方式：0:快速更新 1:滚动更新
UpdateIvl 否 否 Int64 滚动更新必填，更新间隔
ClusterId 是 否 String 集群ID
CpuRequest 否 否 String 初始分配的 CPU 核数，对应 K8S request
MemRequest 否 否 String 初始分配的内存 MiB 数，对应 K8S request
GroupResourceType 否 否 String 部署组资源类型
SubnetId 否 否 String 子网ID
AgentCpuRequest 否 否 String agent 容器分配的 CPU 核数，对应 K8S 的 request
AgentCpuLimit 否 否 String agent 容器最大的 CPU 核数，对应 K8S 的 limit
AgentMemRequest 否 否 String agent 容器分配的内存 MiB 数，对应 K8S 的 request
AgentMemLimit 否 否 String agent 容器最大的内存 MiB 数，对应 K8S 的 limit
IstioCpuRequest 否 否 String istioproxy 容器分配的 CPU 核数，对应 K8S 的 request
IstioCpuLimit 否 否 String istioproxy 容器最大的 CPU 核数，对应 K8S 的 limit
IstioMemRequest 否 否 String istioproxy 容器分配的内存 MiB 数，对应 K8S 的 request
IstioMemLimit 否 否 String istioproxy 容器最大的内存 MiB 数，对应 K8S 的 limit

3. 输出参数

参数名称 类型 描述
Result String 此参数对外不可见。
返回创建成功的部署组ID，返回null表示失败
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
InvalidParameterValue.ContainergroupProtocolInvalid 协议值非法,限定:TCP/UDP。
InvalidParameterValue.ContainergroupPortInvalid 服务端口值非法。
InvalidParameter.ParamError 参数错误。
InvalidParameterValue.GroupNameExist 部署组名称已存在，请更换其他名称。
InternalError.GroupMasterNuknownError 部署组操作请求MASTER 操作失败。
InvalidParameterValue.ContainergroupInvalidCpuInfo CPU limit 和 request 不能同时为空。
InvalidParameterValue.ContainergroupInvalidMemInfo 内存 limit 和 request 不能同时为空。
InvalidParameterValue.ContainergroupNodePortInvalid 主机端口值非法。
ResourceNotFound.GroupApplicationNotExist 无法获取分组所属应用。
ResourceNotFound.GroupNamespaceNotExist 无法获取分组所属命名空间。
InvalidParameterValue.ContainergroupGroupnameRegexMatchFalse 部署组名称格式不正确,只能包含小写字母、数字及分隔符("-"),且必须以小写字母开头，数字或小写字母结尾。
InvalidParameterValue.ContainergroupGroupnameLegnth 部署组名不能大于60个字符。