文档首页 > > API参考> API> 查询镜像列表

查询镜像列表

分享
更新时间: 2019/09/03 GMT+08:00

功能介绍

查询镜像列表。

URI

GET /v2/manage/repos?filter=center::self|namespace::{namespace}|name::{name}|category::{category}|offset::{offset}|limit::{limit}

参数说明请参见表1

至少要传递一个filter参数。

表1 参数说明

参数名称

是否必选

参数类型

描述

center

String

self或thirdparty,自己的镜像或第三方镜像,默认值为self。

namespace

String

组织名称

name

String

镜像仓库名称

category

String

镜像仓库分类

offset

String

起始索引。注意:offset和limit参数需要配套使用。

limit

String

返回条数。

注意:offset和limit参数需要配套使用。

请求消息

N/A

响应消息

响应参数

表2 Response Header参数说明

参数

参数类型

描述

Content-Range

String

offset(开始索引)-count(当前页记录条数)/total(总记录条数)

说明:

如果请求时传入offset和limit参数,则在Response Header中会增加Content-Range。

表3 Response Body参数说明

参数

参数类型

描述

name

String

仓库名称

category

String

仓库类型

description

String

仓库描述

size

Integer

仓库镜像总大小

is_public

Boolean

是否为公有镜像,值为true或false。

num_images

Integer

仓库下镜像版本数量

num_download

Integer

下载次数

created_at

String

仓库创建时间,UTC日期格式,时间为UTC标准时间,用户需要根据本地时间计算偏移量;如东8区需要+8:00。

updated_at

String

仓库更新时间,UTC日期格式,时间为UTC标准时间,用户需要根据本地时间计算偏移量;如东8区需要+8:00。

logo

String

仓库logo地址(预留)

url

String

仓库logo的url地址(预留)

path

String

集群外部docker pull 地址例如:

swr.cn-north-1.myhuaweicloud.com/namespace/repository。

internal_path

String

集群内部docker pull地址。例如:10.125.0.198:20202/namespace/repository。

domain_name

String

用户名

namespace

String

组织名称

tags

Array of strings

镜像版本列表

status

Boolean

状态(预留)

响应示例
[
    {
        "name": "nginx",
        "category": "linux",
        "size": 200977474,
        "is_public": false,
        "num_images": 2,
        "num_download": 0,
        "created_at": "2017-01-01T00:00:00Z",
        "updated_at": "2017-09-11T03:00:02.542841141Z",
        "logo": "",
        "url": "",
        "path": "swr.cn-north-1.myhuaweicloud.com/namespace/repository",
        "internal_path": "10.125.0.198:20202/namespace/repository",
        "domain_name": "root",
        "namespace": "root",
        "tags": [
            "latest",
            "log"
        ],
        "status": false
    }
]

状态码

状态码如表4所示。

表4 状态码

状态码

描述

200

请求成功。

400

错误请求,返回错误信息。

401

鉴权失败的报错信息。

500

服务器内部错误,返回错误信息。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区