接口功能介绍
查询使用镜像文件来创建私有镜像的任务列表。
接口约束
无
URI
GET /v4/image/list-import-tasks
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池 ID。可使用资源池列表查询接口来查询您可见的资源池的列表。 | 88f8888888dd88ec888888888d888d8b | |
pageNo | 否 | Integer | 页码,取值范围:最小 1(默认值)。 | 1 | |
pageSize | 否 | Integer | 每页记录数目,取值范围:最小 1,最大 50,默认值 10。 | 10 |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码,取值范围(值:描述): 800:成功 900:失败 |
800 | |
error | String | 错误码(product.module.code 三段式码)。 | ||
errorCode | String | 同“error”参数。 | ||
message | String | 响应状态描述(一般为英文)。 | ||
description | String | 响应状态描述(一般为中文)。 | ||
returnObj | Object | 返回参数。 | returnObj |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
imageImportTasks | Array of Objects | 创建私有镜像(镜像文件)任务列表。 | imageImportTasks | |
pageNo | Integer | 当前页码。注意:此参数即将弃用。若有获取当前页码需要,则请使用 currentPage。 | 1 | |
currentPage | Integer | 当前页码。 | 1 | |
pageSize | Integer | 当前页记录数目。注意:此参数即将弃用。若有获取当前页记录数目需要,则请使用 currentCount。 | 10 | |
currentCount | Integer | 当前页记录数目。 | 10 | |
totalCount | Integer | 总记录数。 | 1 |
表 imageImportTasks
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
imageName | String | 镜像名称。 | CentOS-test | |
osType | String | 操作系统类型。取值范围(值:描述): linux:Linux 系操作系统 windows:Windows 系操作系统 |
linux | |
taskID | String | 任务 ID。 | 8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa | |
taskStatus | String | 任务状态。取值范围(值:描述): fail:失败 pending:创建中 |
pending |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"regionID": "88f8888888dd88ec888888888d888d8b",
"pageNo": 1,
"pageSize": 10
}
响应示例
{
"statusCode": 800,
"errorCode": "",
"message": "SUCCESS",
"description": "成功",
"returnObj": {
"imageImportTasks": [
{
"imageName": "CentOS-test",
"osType": "linux",
"taskID": "8d8e8888-8ed8-88b8-88cb-888f8b8cf8fa",
"taskStatus": "pending"
}
],
"pageNo": 1,
"currentPage": 1,
"pageSize": 1,
"currentCount": 1,
"totalCount": 1
}
}
状态码
请参考 状态码
错误码
请参考 错误码