接口功能介绍

调用getAppInstVersion接口获取指定应用实例版本详情

接口约束

无

URI

GET /v2/app/inst/getAppInstVersion

路径参数 无

Query参数

参数	是否必填	参数类型	说明	示例	下级对象
appDeployUuid	是	String	应用实例uuid
appDeployInstVersionUuid	是	String	应用实例版本uuid

请求参数

请求头header参数

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

请求体body参数 无

响应参数

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

表 returnObj

参数	参数类型	说明	下级对象
appDeployUuid	String	应用实例uuid
appDeployCode	String	应用实例名称
appUuid	String	应用uuid
appName	String	应用名称
envUuid	String	环境uuid
clusterUuid	String	集群uuid
clusterNamespace	String	集群命名空间
techStackUuid	String	技术栈uuid
techStackVersion	String	技术栈版本
techArch	String	技术栈
deployUnitList	Array of Strings	部署单元列表
appDeployInstVersionUuid	String	应用实例版本uuid
version	String	应用实例版本
comment	String	应用实例版本名称
type	String	应用类型
packageSource	String	制品来源
packageName	String	制品名称
packageVer	String	制品版本
dockerfileContent	String	dockerfile
instanceId	String	镜像服务实例id
namespace	String	镜像服务实例命名空间
repositoryId	String	镜像服务实例仓库ID
imageUrl	String	镜像地址
imageName	String	镜像名称
imageVer	String	镜像版本
imageType	String	镜像仓库类型
imageSecret	String	镜像密钥
crType	String	镜像仓库
crConnectionUuid	String	服务连接CR类型connectionUuid
ecsIds	Array of Strings	ECS uuid
replicas	Integer	应用实例pod数
runtimeEnvCode	String	运行环境code
runtimeEnvVer	String	运行环境版本
activateMsgc	Boolean	是否接入微服务治理中心
activateApm	Boolean	是否接入应用性能监控
csmEnable	Boolean	是否接入服务网格
source	String	来源
epProjectId	String	企业项目id
imagePlatform	String	镜像架构
appGroupUuid	String	应用分组uuid
msManagement	Object	微服务治理	msManagement
istioService	Object	服务网格	istioService
flowPrevention	Object	限流降级	flowPrevention
podResourceSpec	Object	Pod资源	podResourceSpec
startCommand	Object	启动命令	startCommand
envVariableList	Array of Objects	环境变量	envVariableList
localStorage	Object	本地存储	localStorage
schedulingRule	Object	调度规则	schedulingRule
lifeCycleMgt	Object	应用生命周期管理	lifeCycleMgt
logConfigList	Array of Objects	日志收集管理	logConfigList
configMgtList	Array of Objects	配置管理	configMgtList
dnsConfigMgt	Object	DNS配置	dnsConfigMgt
labelList	Array of Objects	标签（Label）配置	labelList
tomcatConfig	Object	Tomcat配置	tomcatConfig
javaStartUpConfig	Object	Java启动参数配置	javaStartUpConfig
annotationList	Array of Objects	注解（Annotation）配置	annotationList
sidecars	Array of Objects	Sidecar配置	sidecarAndInitContainer
initContainers	Array of Objects	InitContainer配置	sidecarAndInitContainer
pvcMountDescs	Array of Objects	PVC挂载	pvcMountDescs
pvcTemplates	Array of Objects	PVC模板	pvcTemplates

表 pvcTemplates

参数	参数类型	说明
templateName	String	PVC模板名称
mountPath	String	挂载路径
storageClassName	String	存储类型
requestStorage	Integer	容量最小为1Gi
accessModes	Array of Strings	访问模式

表 pvcMountDescs

参数	参数类型	说明	下级对象
volumeName	String	挂载名称
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
contextPath	String	自定义路径
maxThreads	Integer	最大线程数
uriEncoding	String	Tomcat编码

表 labelList

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

表 dnsConfigMgt

参数	参数类型	说明	下级对象
dnsPolicy	String	DNS策略
enableHostNetwork	Boolean	使用宿主机网络开关
hostAliases	Object	域名别名	hostAliases

表 hostAliases

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

表 configMgtList

参数	参数类型	说明	下级对象
configType	String	配置类型
mountType	String	挂载类型
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	是否只读
mountPath	String	容器挂载路径
subPathExpr	String	子目录表达式

表 localVolumeList

参数	参数类型	说明
type	String	文件类型
nodePath	String	宿主机挂载目录
mountPath	String	容器挂载目录

表 envVariableList

参数	参数类型	说明
type	String	变量类型
name	String	变量名
value	String	变量值/变量引用
referenceName	String	变量引用名

表 startCommand

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

表 podResourceSpec

参数	参数类型	说明
cpuLimit	Float	cpu上限
cpuRequest	Float	cpu下限
memoryLimit	Integer	内存上限
memoryRequest	Integer	内存下限

表 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	通过就绪检查前完成服务预热

枚举参数

无

请求示例

请求url

无

请求头header

无

请求体body

无

响应示例

{
    "statusCode": 2000,
    "message": "SUCCESS",
    "returnObj": {
        "podResourceSpec": {
            "cpuLimit": 0.0,
            "cpuRequest": 1.0,
            "memoryLimit": 0,
            "memoryRequest": 1024
        },
        "schedulingRule": {
            "mode": "BUILT_IN_CONFIG",
            "deployAcrossNodes": false,
            "deployAcrossZones": false,
            "nodeAffinity": null,
            "podAffinity": null,
            "podAntiAffinity": null,
            "tolerationList": null
        },
        "envVariableList": [
            {
                "type": "COMMON_ENV_VAR",
                "name": "NacosAddr",
                "value": "192.168.8.4:47588",
                "referenceName": ""
            },
            {
                "type": "COMMON_ENV_VAR",
                "name": "NamespaceId",
                "value": "prod",
                "referenceName": ""
            },
            {
                "type": "COMMON_ENV_VAR",
                "name": "Username",
                "value": "nacos",
                "referenceName": ""
            },
            {
                "type": "COMMON_ENV_VAR",
                "name": "PwCode",
                "value": "YqP2@iQs14w_e3af029caa9caea9b831188f1f3a28ef51787470",
                "referenceName": ""
            },
            {
                "type": "COMMON_ENV_VAR",
                "name": "SERVICE_NAME",
                "value": "test.qllllkz.go-provider",
                "referenceName": ""
            }
        ],
        "localStorage": {
            "localVolumeList": [],
            "emptyDirList": []
        },
        "dnsConfigMgt": {
            "dnsPolicy": "ClusterFirst",
            "enableHostNetwork": null,
            "dnsConfig": null,
            "hostAliases": []
        },
        "appDeployCode": "go-provider",
        "name": "go-provider",
        "appUuid": "e742ebb627b940f49ff846efe0a59d9e",
        "appName": "go-provider",
        "envUuid": "d5ae1a51ba374957bfcedc6ff5fd386d",
        "clusterUuid": "5fc9c521868645669d18f2a5df4b6b01",
        "clusterNamespace": "default",
        "techStackUuid": "5a855e4bbeb149b8b91c3eca67816973",
        "techStackVersion": "1.0.0-g121",
        "techArch": "GO",
        "deployUnitList": [
            "ade272694caf46c5aac1054b38f9e6e9",
            "047321bcd24347b19e74b83f8c32d942",
            "c5d5885aebbb4182a0d952f99216950d"
        ],
        "version": "20250122090936629",
        "type": "IMAGE",
        "activateMsgc": false,
        "activateApm": true,
        "csmEnable": false,
        "apmSwitch": 1,
        "msgcSwitch": 0,
        "specType": 0,
        "source": 1,
        "crType": "MSAP",
        "imageSrc": "INTERNAL",
        "instanceId": "1714992900312588292",
        "namespace": "msap-demo-project",
        "repositoryId": "1853366458575228930",
        "imageUrl": "10.50.208.195:32000/msap-demo-project/go-provider",
        "imageName": "go-provider",
        "imageVer": "1.0.0",
        "imageType": "2",
        "imagePlatform": "amd64",
        "appGroupUuid": "f5cc75c4b7af4419b10f62f8a351b0db",
        "epProjectId": "0"
    }
}

状态码

请参考状态码

错误码

请参考错误码

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

微服务云应用平台

微服务云应用平台

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

微服务云应用平台

微服务云应用平台

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码