1. 查询容器实例列表

本接口用于查询容器实例列表。

该接口用于查询用户已创建未删除的容器实例列表。
该接口为同步接口，接口调用后会直接返回查询结果。
该接口会以列表的形式返回所有符合条件的容器实例信息。

1.1. 接口说明

本接口所属服务类型为 ackcs

本接口操作类型为 DescribeServices

1.1.1. 请求路径

POST {baseUrl}/v3/ackcs/DescribeServices

1.1.2. 请求体

{
	"aliasName": "kcs-pzunmwju",
	"serviceUuid": "ackcs-00x2qyak",
	"serviceStatus": "Running",
	"serviceType": "rtx3090",
	"pageNum": 1,
	"pageSize": 100,
	"zoneCode": "cn-zhongwei-ac"
}

请求体内容说明

属性名	属性类型	是否必须	查询方式	说明
aliasName	String	否	等值查询	待查询容器实例名称
serviceUuid	String	否	等值查询	待查询容器实例 UUID
serviceStatus	String	否	等值查询	待查询容器实例状态
serviceType	String	否	等值查询	待查询容器实例类型
pageNum	Integer	否	等值查询	页号
pageSize	Integer	否	等值查询	页大小

1.1.3. 返回内容

{
	"code": 200,
	"message": "获取容器实例列表成功",
	"data": {
		"pageNum": 1,
		"pageSize": 100,
		"rows": [{
			"image": {
				"imageUuid": "ackci-00x2qxvx",
				"imageName": "PyTorch-20.12-Py3",
				"imageType": "custom",
				"imageOs": "Ubuntu",
				"imageVersion": "22.04",
				"imageArch": "64bit",
				"imageDesc": "测试容器镜像",
				"vhostType": "rtx3090",
				"platformName": "PyTorch",
				"platformVersion": "1.8.0a0+1606899",
				"createdTime": "Feb 21, 2024 10:12:55 AM",
				"updatedTime": "Apr 16, 2024 5:59:12 PM"
			},
			"operatingSystem": "Ubuntu",
			"instanceType": {
				"serviceModel": "rtx3090.epyc7402.2xlarge",
				"serviceType": "rtx3090",
				"serviceCpus": 22,
				"serviceMemory": 107374182400,
				"serviceGpus": 2.0,
				"serviceGpumem": 51539607552
			},
			"zone": {
				"regionCode": "cn-zhongwei",
				"regionName": "中卫",
				"zoneCode": "cn-zhongwei-ac",
				"zoneName": "中卫一区"
			},
			"aliasName": "kcs-pzunmwju",
			"createdTime": "Jul 2, 2024 2:40:43 PM",
			"updatedTime": "Jul 2, 2024 3:05:22 PM",
			"billingType": "PrePaid",
			"prepaidTime": "Jul 2, 2024 2:40:42 PM",
			"payPeriod": 1,
			"expireStrategy": "AutoDelete",
			"expireTime": "Aug 2, 2024 2:40:42 PM",
			"autoRenewCnt": 0,
			"destroyTime": "Aug 5, 2024 2:40:42 PM",
			"serviceStatus": "Running"
		}]
	}
}

返回体内容说明

属性名	属性类型	说明
aliasName	String	容器实例别名
autoRenewCnt	Integer	包月容器实例自动续费月数
billingType	String	容器实例计费类型
createdTime	Datetime	容器实例创建时间
updatedTime	Datetime	容器实例更新时间
expireStrategy	String	包月容器实例到期策略
expireTime	Datetime	包月容器实例到期时间
destroyTime	Datetime	策略为到期删除的包月容器实例最后删除时间
image	Image	容器实例用到的镜像
instanceType	InstanceType	容器实例规格信息
payPeriod	Integer	购买月数，例如：payPeriod=1表示购买1个月
prepaidTime	Datetime	包月容器实例的包月开始时间
serviceStatus	String	容器实例状态
serviceUuid	String	容器实例唯一 id
zone	Zone	容器实例所属可用区信息

💡

容器实例状态serviceStatus属性值详见容器实例状态

更配容器实例查询容器实例JupyterLab信息