接口功能介绍

调用addAppInstVersion接口新增应用实例版本

接口约束

无

URI

POST /v2/app/inst/addAppInstVersion

路径参数 无

Query参数 无

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例	下级对象
regionId	是	String	资源池ID，请参考调用前必知-概述	bb9fdb42056f11eda1610242ac110002

请求体body参数

参数	是否必填	参数类型	说明	下级对象
appDeployUuid	是	String	应用实例uuid
version	是	String	应用实例版本，长度不能低于3个字符，不能超过30个字符，只能以字母或者数字开头，字母、数字、中划线组成的字符串
comment	是	String	应用实例版本名称,长度不能低于3个字符，不能超过30个字符
clusterType	是	String	集群类型，只能为ECS或KUBERNETES
type	是	String	应用类型，仅支持程序包PACKAGE或镜像IMAGE
packageSource	否	String	制品来源，当type为PACKAGE时必填
packageUuid	否	String	制品uuid，当type为PACKAGE时必填
packageVer	否	String	制品版本，当type为PACKAGE时必填
dockerfileContent	否	String	dockerfile，当clusterType为KUBERNETES和type为PACKAGE时必填
instanceId	否	String	镜像服务实例id，当type为IAMGE时必填
namespace	否	String	镜像服务实例命名空间，当type为IAMGE时必填
repositoryId	否	String	镜像服务实例仓库ID，当type为IAMGE时必填
imageUrl	否	String	镜像地址，当type为IAMGE时必填
imageName	否	String	镜像名称，当type为IAMGE时必填
imageVer	否	String	镜像版本，当type为IAMGE时必填
imageType	否	String	镜像仓库类型，只支持自购镜像仓库1和MSAP镜像仓库3，当type为IAMGE时必填
imageSecret	否	String	镜像密钥
crType	否	String	镜像仓库仅支持自购镜像仓库ORDER和MSAP镜像仓库MSAP，当clusterType为KUBERNETES时必填
crConnectionUuid	否	String	服务连接CR类型connectionUuid，当crType为ORDER时必填
ecsIds	否	Array of Strings	ECS uuid，取值属性：ecsUuid，当clusterType为ECS时必填
replicas	否	Integer	应用实例pod数，取值范围0~99，当clusterType为KUBERNETES时必填
activateMsgc	是	Boolean	是否接入微服务治理中心
activateApm	是	Boolean	是否接入应用性能监控
csmEnable	否	Boolean	是否接入服务网格，当clusterType为KUBERNETES时必填
epProjectId	是	String	企业项目id
msManagement	否	Object	微服务治理，适用于KUBERNETES和ECS	msManagement
istioService	否	Object	服务网格，适用于KUBERNETES	istioService
flowPrevention	否	Object	限流降级，适用于KUBERNETES和ECS	flowPrevention
podResourceSpec	否	Object	Pod资源，适用于KUBERNETES，当clusterType为KUBERNETES时必填	podResourceSpec
startCommand	否	Object	启动命令，适用于KUBERNETES	startCommand
envVariableList	否	Array of Objects	环境变量，适用于KUBERNETES	envVariableList
localStorage	否	Object	本地存储，适用于KUBERNETES	localStorage
schedulingRule	否	Object	调度规则，适用于KUBERNETES	schedulingRule
lifeCycleMgt	否	Object	应用生命周期管理，适用于KUBERNETES	lifeCycleMgt
logConfigList	否	Array of Objects	日志收集管理，适用于KUBERNETES	logConfigList
configMgtList	否	Array of Objects	配置管理，适用于KUBERNETES	configMgtList
dnsConfigMgt	否	Object	DNS配置，适用于KUBERNETES	dnsConfigMgt
labelList	否	Array of Objects	标签（Label）配置，适用于KUBERNETES	labelList
tomcatConfig	否	Object	Tomcat配置，适用于KUBERNETES和ECS	tomcatConfig
javaStartUpConfig	否	Object	Java启动参数配置，适用于KUBERNETES和ECS	javaStartUpConfig
annotationList	否	Array of Objects	注解（Annotation）配置，适用于KUBERNETES	annotationList
sidecars	否	Array of Objects	Sidecar配置，适用于KUBERNETES	sidecarAndInitContainer
initContainers	否	Array of Objects	InitContainer配置，适用于KUBERNETES	sidecarAndInitContainer
pvcMountDescs	否	Array of Objects	PVC挂载，适用于KUBERNETES	pvcMountDescs
pvcTemplates	否	Array of Objects	PVC模板，适用于KUBERNETES	pvcTemplates

表 pvcTemplates

参数	是否必填	参数类型	说明
templateName	是	String	PVC模板名称，长度不能低于1个字符，不能超过100个字符，由小写字母、数字及-组成，且开始和结尾只能是数字和字母
mountPath	是	String	挂载路径
storageClassName	是	String	存储类型
requestStorage	是	Integer	容量最小为1Gi
accessModes	是	Array of Strings	访问模式

表 pvcMountDescs

参数	是否必填	参数类型	说明	下级对象
volumeName	是	String	挂载名称，长度不能低于1个字符，不能超过100个字符，由小写字母、数字及-组成，且开始和结尾只能是数字和字母
pvcName	是	String	PVC名称
mountPaths	是	Array of Objects	挂载配置列表	mountPaths

表 mountPaths

参数	是否必填	参数类型	说明	示例	下级对象
mountPath	是	String	挂载目录
readOnly	是	Boolean	挂载模式

表 sidecarAndInitContainer

参数	是否必填	参数类型	说明	示例	下级对象
yamlEncoded	是	String	yaml数据内容

表 annotationList

参数	是否必填	参数类型	说明	示例	下级对象
name	是	String	名称
value	是	String	值

表 javaStartUpConfig

参数	是否必填	参数类型	说明	下级对象
initialHeapSize	否	Object	初始堆内存	javaStartUp
maxHeapSize	否	Object	最大堆内存	javaStartUp
newSize	否	Object	初始年轻代	javaStartUp
maxNewSize	否	Object	最大年轻代	javaStartUp
survivorRatio	否	Object	Eden/Survivor比例	javaStartUp
newRatio	否	Object	老年代/新生代比例	javaStartUp
permSize	否	Object	初始持久代	javaStartUp
maxPermSize	否	Object	最大持久代	javaStartUp
maxDirectMemorySize	否	Object	最大直接内存	javaStartUp
threadStackSize	否	Object	线程栈大小	javaStartUp
youngGarbageCollector	否	Object	年轻代GC策略	javaStartUp
oldGarbageCollector	否	Object	老年代GC策略	javaStartUp
concGcThreads	否	Object	并发线程数	javaStartUp
parallelGcThreads	否	Object	并行线程数	javaStartUp
g1HeapRegionSize	否	Object	G1 HeapRegion	javaStartUp
printGc	否	Object	打印GC	javaStartUp
printGcDateStamps	否	Object	打印GC时间	javaStartUp
gcLogFilePath	否	Object	GC日志目录	javaStartUp
useGcLogFileRotation	否	Object	useGcLogFileRotation	javaStartUp
numberOfGcLogFiles	否	Object	numberOfGcLogFiles	javaStartUp
heapDumpOnOutOfMemoryError	否	Object	打印heap dump oom错误信息	javaStartUp
heapDumpPath	否	Object	Dump路径	javaStartUp
customParams	否	Object	自定义	javaStartUp

表 javaStartUp

参数	是否必填	参数类型	说明	示例	下级对象
original	是	String	original
startUp	是	String	启动参数

表 tomcatConfig

参数	是否必填	参数类型	说明
useDefaultConfig	否	Boolean	是否使用Tomcat默认配置
httpPort	否	Integer	应用端口
contextInputType	否	String	Tomcat Context，可选值为WAR、ROOT、CUSTOM
contextPath	否	String	自定义路径
maxThreads	否	Integer	最大线程数
uriEncoding	否	String	Tomcat编码，可填值为UTF-8、ISO-8859-1、GBK、GB2312

表 labelList

参数	是否必填	参数类型	说明	示例	下级对象
name	是	String	标签名
value	是	String	标签值

表 dnsConfigMgt

参数	是否必填	参数类型	说明	下级对象
dnsPolicy	是	String	DNS策略，填写内容可为ClusterFirst、ClusterFirstWithHostNet、Default和None
enableHostNetwork	否	Boolean	使用宿主机网络开关
hostAliases	否	Object	域名别名	hostAliases

表 hostAliases

参数	是否必填	参数类型	说明	示例	下级对象
ip	是	String	IP地址
hostnames	是	Array of Strings	主机名

表 configMgtList

参数	是否必填	参数类型	说明	下级对象
configType	是	String	配置类型，目前默认只支持配置项CONFIG_MAP和SECRET
mountType	是	String	挂载类型, 目前默认只支持挂载到文件MOUNT_FILE
mountSource	是	String	挂载源
mountMasterDir	是	String	挂载主目录
fileMountType	是	String	文件挂载方式
mountConfigList	是	Array of Objects	指定配置项下各文件的挂载	mountConfigList

表 mountConfigList

参数	是否必填	参数类型	说明	示例	下级对象
name	是	String	挂载key
mountPath	是	String	挂载文件路径

表 logConfigList

参数	是否必填	参数类型	说明
logProject	否	String	日志项目
logStore	否	String	日志单元
logType	否	String	采集日志类型
logDir	否	String	采集路径
logRule	否	String	采集规则名称
logProjectCode	否	String	日志项目code
logStoreCode	否	String	日志单元code
logRuleCode	否	String	采集规则code
isTrace	否	Boolean	是否设置调用链

表 lifeCycleMgt

参数	是否必填	参数类型	说明	示例	下级对象
liveness	否	Object	Liveness配置		liveness
readiness	否	Object	Readiness配置，与liveness参数相同		liveness

表 liveness

参数	是否必填	参数类型	说明	下级对象
enabled	否	Boolean	是否开启Liveness配置
initialDelaySeconds	否	Integer	initialDelaySeconds
periodSeconds	否	Integer	periodSeconds
successThreshold	否	Integer	successThreshold
timeoutSeconds	否	Integer	timeoutSeconds
failureThreshold	否	Integer	failureThreshold
mode	否	String	模式
exec	否	Object	命令	exec
httpGet	否	Object	httpGet	httpGet
tcpSocket	否	Object	tcpSocket	tcpSocket

表 tcpSocket

参数	是否必填	参数类型	说明	示例	下级对象
host	否	String	host
port	否	Integer	port

表 httpGet

参数	是否必填	参数类型	说明	下级对象
host	否	String	host
path	否	String	path
port	否	Integer	port
scheme	否	String	scheme
headerList	否	Array of Objects	HttpHeaders	headerList

表 headerList

参数	是否必填	参数类型	说明	示例	下级对象
name	否	String	名称
value	否	String	变量值

表 exec

参数	是否必填	参数类型	说明	示例	下级对象
command	否	Array of Strings	命令列表

表 schedulingRule

参数	是否必填	参数类型	说明	下级对象
mode	是	String	模式，分为内置配置和自定义配置
deployAcrossNodes	否	Boolean	节点调度，适用于内置配置
deployAcrossZones	否	Boolean	可用区调度，适用于内置配置
nodeAffinity	否	Object	节点亲和性，适用于自定义配置	nodeAffinity
podAffinity	否	Object	应用亲和性，适用于自定义配置	podAffinity
podAntiAffinity	否	Object	应用反亲和性，适用于自定义配置	podAffinity
tolerationList	否	Array of Objects	调度容忍，适用于自定义配置	tolerationList

表 tolerationList

参数	是否必填	参数类型	说明
labelName	否	String	标签名称
operator	否	String	操作符号
labelValue	否	String	标签值
effect	否	String	效果
tolerationSeconds	否	Integer	容忍时间（秒）

表 podAffinity

参数	是否必填	参数类型	说明	示例	下级对象
requiredRuleList	否	Array of Objects	必须满足条件		podRequiredRuleList
preferredRuleList	否	Array of Objects	尽可能满足条件		podPreferredRuleList

表 podPreferredRuleList

参数	是否必填	参数类型	说明	下级对象
weight	否	Integer	权重
namespace	否	String	命名空间
topologyKey	否	String	拓扑域
conditionList	否	Array of Objects	选择器	conditionList

表 podRequiredRuleList

参数	是否必填	参数类型	说明	下级对象
namespace	否	String	命名空间
topologyKey	否	String	拓扑域
conditionList	否	Array of Objects	选择器	conditionList

表 nodeAffinity

参数	是否必填	参数类型	说明	示例	下级对象
requiredRuleList	否	Array of Objects	必须满足节点亲和性规则		requiredRuleList
preferredRuleList	否	Array of Objects	尽量满足节点亲和性规则		preferredRuleList

表 preferredRuleList

参数	是否必填	参数类型	说明	示例	下级对象
weight	是	Integer	权重
conditionList	是	Array of Objects	选择器列表		conditionList

表 requiredRuleList

参数	是否必填	参数类型	说明	示例	下级对象
conditionList	是	Array of Objects	选择器列表		conditionList

表 conditionList

参数	是否必填	参数类型	说明
labelName	是	String	标签名称
operator	是	String	操作符号
labelValueList	是	Array of Strings	节点标签值

表 localStorage

参数	是否必填	参数类型	说明	示例	下级对象
localVolumeList	是	Array of Objects	宿主机文件挂载到容器内的配置		localVolumeList
emptyDirList	否	Array of Objects	配置K8s emptyDir挂载，支持将emptyDir卷挂载到指定的容器目录		emptyDirList

表 emptyDirList

参数	是否必填	参数类型	说明
readOnly	否	Boolean	是否只读，可选，true为只读，false为读写，默认为false
mountPath	是	String	容器挂载路径
subPathExpr	否	String	子目录表达式

表 localVolumeList

参数	是否必填	参数类型	说明
type	是	String	文件类型，可填 DEFAULT（默认）、DIRECTORY_OR_CREATE（创建文件目录）、DIRECTORY（文件目录）、FILE_OR_CREATE（创建文件）、FILE(文件)、SOCKET（Socket）、CHAR_DEVICE（CharDevice）
nodePath	是	String	宿主机挂载目录
mountPath	是	String	容器挂载目录

表 envVariableList

参数	是否必填	参数类型	说明
type	是	String	变量类型,分为keyValue/fieldRef/配置项/保密字典
name	是	String	变量名
value	是	String	变量值/变量引用
referenceName	否	String	变量引用名

表 startCommand

参数	是否必填	参数类型	说明	示例	下级对象
command	是	String	启动命令
args	是	Array of Strings	启动参数

表 podResourceSpec

参数	是否必填	参数类型	说明
cpuLimit	是	Float	cpu上限，为0时不做资源限制，如需限制，请至少填写0.001核，最大值为32核
cpuRequest	是	Float	cpu下限，最小值为0.001核，最大值为32核
memoryLimit	是	Integer	内存上限，为0时不做资源限制，如需限制，请至少填写256MB，最大值为65536MB
memoryRequest	是	Integer	内存下限，最小值为256MB，最大值为65536MB

表 flowPrevention

参数	是否必填	参数类型	说明	示例	下级对象
enableMhas	否	Boolean	是否接入限流降级

表 istioService

参数	是否必填	参数类型	说明
protocol	是	String	服务网格协议
name	是	String	服务网格服务名称
port	是	Integer	服务网格服务端口

表 msManagement

参数	是否必填	参数类型	说明
registerCenterInstId	否	String	注册中心实例ID，不传代表使用自建注册中心
useAppRegisterConfig	否	Boolean	是否开启注册中心配置覆盖，默认false
enableEmptyPushReject	否	Boolean	是否开启推空保护
enabled	否	Boolean	是否开启无损上下线
losslessOfflineNotice	否	Boolean	是否开启无损下线主动通知，默认false
warmupTime	否	Integer	预热时长，单位为秒, 0-86400
funcType	否	Integer	预热曲线类型, 0-20
delayTime	否	Integer	延迟注册时间，单位为秒, 0-86400
aligned	否	Boolean	通过就绪检查前完成服务注册
related	否	Boolean	通过就绪检查前完成服务预热

响应参数

参数	参数类型	说明	下级对象
statusCode	Integer	响应编码 2000 success
message	String	消息内容
returnObj	Object	返回数据	returnObj
error	String	调用错误时返回的错误编码

表 returnObj

参数	参数类型	说明	示例	下级对象
appDeployUuid	String	应用实例uuid

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

{
  "envUuid": "e5fd85fc7f014d938e972a5413072e2e",
  "appUuid": "810b1e0bd6a2470ab6587e9c41c4836f",
  "techStackUuid": "tech_stack_219376697886113792",
  "clusterType": "ECS",
  "name": "consumer",
  "version": "20241225",
  "deployUnitList": [
    "3515bedc48f94d5b8443e8cc74af21e9",
        "609788d274844936a11843f166cb29f8",
        "2485fd08605b44d08291d07dae52ffca",
        "e4252e5175304beea36e7839a5b835c2"
  ],
  "comment": "测试Ecs应用实例",
  "clusterUuid": "58c6990b472043b382bd268f88f397c8",
  "type": "PACKAGE",
  "packageSource": "EXISTED_PACKAGE",
  "packageUuid": "e9e878f06da84475b6b0e96d1b25e51c",
  "packageVer": "4.2",
  "dockerfileContent": "",
  "ecsIds": [
    "672e829dd00b4727a6a3f5ce657d7bdb"
  ],
  "activateMsgc": true,
  "activateApm": false,
  "epProjectId": "0"
}

响应示例

{
    "statusCode": 2000,
    "message": "成功",
    "returnObj": {
        "appDeployUuid": "cfe8c62e3a1a4b80bb7eb841254bd05c"
    }
}

状态码

请参考状态码

错误码

请参考错误码

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

微服务云应用平台

微服务云应用平台

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

微服务云应用平台

微服务云应用平台

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码