微服务平台 TSF 部署容器应用

1. 接口描述

接口请求域名： tsf.tencentcloudapi.com 。

部署容器应用-更新

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

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：DeployContainerGroup。
Version	是	String	公共参数，本接口取值：2018-03-26。
Region	是	String	公共参数，详见产品支持的地域列表。
GroupId	是	String	部署组ID，分组唯一标识示例值：group-6a79x94v
TagName	是	String	镜像版本名称,如v1 示例值：v1
InstanceNum	是	Integer	实例数量示例值：1
Server	否	String	镜像server 示例值：ccr.ccs.tencentyun.com
CpuLimit	否	String	业务容器最大的 CPU 核数，对应 K8S 的 limit；不填时默认为 request 的 2 倍示例值：2
MemLimit	否	String	业务容器最大的内存 MiB 数，对应 K8S 的 limit；不填时默认为 request 的 2 倍示例值：512
JvmOpts	否	String	jvm参数示例值：-Xms512m -Xmx1048m
CpuRequest	否	String	业务容器分配的 CPU 核数，对应 K8S 的 request，默认0.25 示例值：0.54
MemRequest	否	String	业务容器分配的内存 MiB 数，对应 K8S 的 request，默认640 MiB 示例值：1024
DoNotStart	否	Boolean	是否不立即启动示例值：false
RepoName	否	String	（优先使用）新版镜像名，如/tsf/nginx 示例值：tsf_10000617xxxx/test
UpdateType	否	Integer	更新方式：0:快速更新 1:滚动更新示例值：1
UpdateIvl	否	Integer	滚动更新必填，更新间隔示例值：10
AgentCpuRequest	否	String	agent 容器分配的 CPU 核数，对应 K8S 的 request 示例值：0.1
AgentCpuLimit	否	String	agent 容器最大的 CPU 核数，对应 K8S 的 limit 示例值：0.2
AgentMemRequest	否	String	agent 容器分配的内存 MiB 数，对应 K8S 的 request 示例值：32
AgentMemLimit	否	String	agent 容器最大的内存 MiB 数，对应 K8S 的 limit 示例值：128
IstioCpuRequest	否	String	istioproxy 容器分配的 CPU 核数，对应 K8S 的 request 示例值：0.1
IstioCpuLimit	否	String	istioproxy 容器最大的 CPU 核数，对应 K8S 的 limit 示例值：0.2
IstioMemRequest	否	String	istioproxy 容器分配的内存 MiB 数，对应 K8S 的 request 示例值：32
IstioMemLimit	否	String	istioproxy 容器最大的内存 MiB 数，对应 K8S 的 limit 示例值：128
MaxSurge	否	String	kubernetes滚动更新策略的MaxSurge参数示例值：25%
MaxUnavailable	否	String	kubernetes滚动更新策略的MaxUnavailable参数示例值：50%
HealthCheckSettings	否	HealthCheckSettings	健康检查配置信息，若不指定该参数，则默认不设置健康检查。
Envs.N	否	Array of Env	部署组应用运行的环境变量。若不指定该参数，则默认不设置额外的环境变量。
ServiceSetting	否	ServiceSetting	容器部署组的网络设置。
DeployAgent	否	Boolean	是否部署 agent 容器。若不指定该参数，则默认不部署 agent 容器。示例值：true
SchedulingStrategy	否	SchedulingStrategy	节点调度策略。若不指定该参数，则默认不使用节点调度策略。
IncrementalDeployment	否	Boolean	是否进行增量部署，默认为false，全量更新示例值：false
RepoType	否	String	tcr或者不填示例值：personal
VolumeInfos	否	VolumeInfo	数据卷信息-废弃，请用VolumeInfoList参数
VolumeMountInfos	否	VolumeMountInfo	数据卷挂载点信息-废弃，请用VolumeMountInfoList参数
VolumeInfoList.N	否	Array of VolumeInfo	数据卷信息，list
VolumeMountInfoList.N	否	Array of VolumeMountInfo	数据卷挂载点信息，list
VolumeClean	否	Boolean	是否清除数据卷信息，默认false 示例值：false
AgentProfileList.N	否	Array of AgentProfile	javaagent信息: SERVICE_AGENT/OT_AGENT
WarmupSetting	否	WarmupSetting	预热配置信息

3. 输出参数

参数名称	类型	描述
Result	Boolean	部署容器应用是否成功。 true：成功。 false：失败。注意：此字段可能返回 null，表示取不到有效值。示例值：true
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 部署容器应用

输入示例

POST / HTTP/1.1
Host: tsf.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DeployContainerGroup
<公共请求参数>

{
    "DoNotStart": "false",
    "MemRequest": "1024",
    "UpdateType": "1",
    "Server": "ccr.ccs.tencentyun.com",
    "InstanceNum": "1",
    "RepoName": "tsf_10000617xxxx/test",
    "TagName": "v1",
    "CpuRequest": "0.54",
    "JvmOpts": "-Xms128m-Xmx512m-XX:MetaspaceSize=128m-XX:MaxMetaspaceSize=512m",
    "UpdateIvl": "10",
    "GroupId": "group-6a79x94v"
}

输出示例

{
    "Response": {
        "RequestId": "b481cffd-6b00-463f-a1ae-7afe5fd5fa2e",
        "Result": true
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

Tencent Cloud SDK 3.0 for Python: GitHub Gitee
Tencent Cloud SDK 3.0 for Java: GitHub Gitee
Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
Tencent Cloud SDK 3.0 for Go: GitHub Gitee
Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
Tencent Cloud SDK 3.0 for C++: GitHub Gitee
Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

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

错误码	描述
FailedOperation.ClusterQueryFailed	查询集群失败。
FailedOperation.ContainergroupKuberneteApiInvokeError	调用 kube-api-server 失败。
FailedOperation.ContainergroupKubernetesApiInvokeError	调用 kube-api-server 失败。
FailedOperation.ContainergroupKubernetesConnectError	调用 kube-api-server 失败。
FailedOperation.TokenQueryFailed	TOKEN查询失败。
FailedOperation.TsfPrivilegeError	TSF权限模块异常，请联系系统管理员。。
FailedOperation.UnhandledException	模块未处理异常。
InternalError.ContainergroupKuberneteApiInvokeError	访问TKE服务失败。
InternalError.ContainergroupKuberneteConnectError	连接TKE服务失败。
InternalError.ContainergroupSqlFailed	容器应用SQL错误。
InternalError.UnhandledException	[%s]模块未处理异常。。
InvalidParameter.BadRequest	[%s]模块接口[%s]请求不正确（400 BAD REQUEST）。。
InvalidParameter.KubernetesParamError	参数错误。
InvalidParameter.ParamError	参数错误。
InvalidParameterValue.ContainergroupAccesstypeNull	服务访问方式不能为空。
InvalidParameterValue.ContainergroupCpulimitOver	集群 CPU 资源不足。
InvalidParameterValue.ContainergroupEnvValueNotSet	容器 Env 的 Value 和 ValueFrom 至少要有一个。
InvalidParameterValue.ContainergroupGroupidNull	部署组ID不能为空。
InvalidParameterValue.ContainergroupInvalidCpuInfo	CPU limit 和 request 不能同时为空。
InvalidParameterValue.ContainergroupInvalidMemInfo	内存 limit 和 request 不能同时为空。
InvalidParameterValue.ContainergroupMemlimitOver	集群内存资源不足。
InvalidParameterValue.ContainergroupNodePortInvalid	主机端口值非法。
InvalidParameterValue.ContainergroupPortNull	服务端口不能为空。
InvalidParameterValue.ContainergroupPortsRepeat	服务端口不允许重复映射。
InvalidParameterValue.ContainergroupProtocolInvalid	协议值非法,限定:TCP/UDP。
InvalidParameterValue.ContainergroupProtocolMixError	公网访问方式下，协议需要一致。
InvalidParameterValue.ContainergroupProtocolNull	协议不能为空。
InvalidParameterValue.ContainergroupProtocolPortsNull	协议端口不能为空。
InvalidParameterValue.ContainergroupReponameInvalid	镜像仓库名与应用名不匹配。
InvalidParameterValue.ContainergroupResourceAgentValueInvalid	agent 容器资源值非法 , %s。
InvalidParameterValue.ContainergroupTargetPortsRepeat	容器端口不允许重复映射。
InvalidParameterValue.ContainergroupTargetportNull	容器端口不能为空。
InvalidParameterValue.ContainergroupUpdateivlInvalid	更新间隔不能为空或者数值非法。
InvalidParameterValue.ContainergroupUpdatetypeInvalid	updateType参数不合法，值必须为0、1。
InvalidParameterValue.ContainergroupYamlUserContainerNotFound	找不到业务容器。
InvalidParameterValue.ImagerepoRepoNameNull	镜像仓库名不能为空。
InvalidParameterValue.ImagerepoReponameInvalid	镜像仓库名不合法,示例:tsf-repo/nginx。
InvalidParameterValue.ImagerepoTagnameNull	imageTags不能为空。
InvalidParameterValue.WrongDontStartValue	仅有停止状态下的部署组才可以不启动。
MissingParameter.SystemParameterRequired	未指定%s。。
ResourceNotFound.ClusterNotExist	无法获取命名空间所属集群。
ResourceNotFound.ContainergroupGroupNotFound	无法找到该部署组。
ResourceNotFound.MicroserviceOffline	目标微服务已离线[%s]。。
UnauthorizedOperation.NoPrivilege	用户无权限访问该接口。。

部署容器应用

本页目录：