产品文档

容器镜像仓库

describeImages

描述

返回指定repository中images的元数据,包括image size, image tags和creation date。

请求方式

GET

请求地址

https://containerregistry.jdcloud-api.com/v1/regions/{regionId}/images

名称 类型 是否必需 默认值 描述
regionId String True Region ID

请求参数

名称 类型 是否必需 默认值 描述
filters Filter[ ] False registryName - 镜像仓储名称
repositoryName - 镜像库名称
imageDigest - 镜像哈希值
imageTag - 镜像标签
tagStatus - 打标TAGGED或没打标UNTAGGED
pageNumber Integer False 页码;默认为1
pageSize Integer False 分页大小;默认为20;取值范围[10, 100]

Filter

名称 类型 是否必需 默认值 描述
operator String False 过滤条件的操作符,默认eq
values String[ ] True 过滤条件的值
name String True 过滤条件的名称

返回参数

名称 类型 描述
result Result
requestId String

Result

名称 类型 描述
totalCount Number
imageDetails ImageDetail[ ] 镜像列表

ImageDetail

名称 类型 描述
totalPullTimes Integer 镜像被拉取次数
imageManifest String 镜像的Manifest
imageDigest String image manifest的sha256摘要
registryName String image registry 表示镜像的注册表归属
imageTags String[ ] 镜像关联的所有Tag
imageSizeMB Double image在repository中的大小。从Docker 1.9之后的版本, Docker client会压缩镜像层数据再push到V2版本的Docker registry。
docker image命令显示的是解压后的镜像大小,因此会比DescribeImages接口返回的镜像大小会大很多。
lastPullAt String 最近pull的时间
repositoryName String image repository表示镜像的仓库归属
imagePushedAt String 当前image被push到repository的时间

返回码

返回码 描述
400 Invalid parameter
401 Authentication failed
404 Not found
503 Service unavailable
200 OK
500 Internal server error
更新时间:2019-01-22 16:51:42