查询镜像列表

接口说明

分页查询镜像列表,列表按照创建时间降序排列。分页查询支持模糊查询镜像版本imgVersion、镜像名称imgName。若不存在镜像,则返回空列表。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/imgmgr/getImgList

请求参数

Header

参数名称
类型
必填
描述
pool
string
是

资源池ID

Body

参数名称
类型
必填
描述
req
OpenapiImageReq
是

req

currentPage
integer(int32)
否

页码,默认为1

imgName
string
否

镜像名称

imgType
string
否

镜像类型

imgVersion
string
否

镜像版本

opSystem
string
否

操作系统

pageSize
integer(int32)
否

每页条数,默认为10

请求示例

POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/resource/zh/imgmgr/getImgList
{
	"currentPage":1,
	"pageSize":10
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
EPage«ImageDto»

响应体

list
<ImageDto> array

当前页数据

containerImgName
string

容器镜像名称

content
string

构建内容

createTime
string(date-time)

创建时间

description
string

镜像说明

imgDescription
string

镜像描述

imgId
string

镜像ID

imgName
string

镜像名称

imgSource
string

镜像来源0:镜像同步 1:云机自定义创建

imgTag
string

镜像Tag

imgType
string

镜像类型 1:标准 2:自定义

imgVersion
string

镜像版本

isForbid
string

镜像是否禁用(默认禁用),1 禁用, 0 启用

opSystem
string

操作系统

poolId
string

资源池ID

prepareType
integer(int32)

预置备版本类型(1政企版、2公众版、3行业版、4专属版、5尊享版)

total
integer(int64)

结果总数量

totalPage
integer(int32)

结果总页数

errorCode
string

错误编码

errorMessage
string

错误信息

requestId
string

请求id

state
string

状态值

返回示例

返回码:200
OK
{
	"errorCode":"00000000",
	"errorMessage":"请求成功",
	"requestId":"5c7e264f-7cc5-4230-b6de-9cc4f5a13ab0",
	"state":"OK",
	"body":{
		"total":5,
		"totalPage":5,
		"list":[
			{
				"imgId":"1899004374785490946",
				"imgTag":"cpharbor.cmecloud.cn:8443/cloudphone/android-1-aosp11:3.2.15-pre-4-zwl",
				"imgName":"ecloud-aosp11-3.2.15-pre-4-zwl",
				"imgVersion":"3.2.15-pre-4-zwl",
				"opSystem":"aosp11",
				"imgType":"1",
				"poolId":"CIDC-RP-45",
				"createTime":"2025-03-10 15:48:19",
				"content":null,
				"tenants":null,
				"containerImgName":null,
				"prepareType":4,
				"availableSold":0,
				"imgDescription":"",
				"imgSource":"0",
				"description":"aosp11-3.2.15-pre-4-zwl",
				"isForbid":null
			}
		]
	}
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。