文档首页/ 容器镜像服务 SWR/ API参考（吉隆坡区域）/ API/ 镜像仓库管理/ 查看共享镜像列表
更新时间：2024-04-19 GMT+08:00
查看PDF
分享

查看共享镜像列表

功能介绍

查看共享镜像列表。

URI

GET /v2/manage/shared-repositories

表1 Query参数

参数

是否必选

参数类型

描述

namespace

否

String

组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。

name

否

String

镜像仓库名称

center

否

String

self: 我共享的镜像。thirdparty: 他人共享给我的镜像

limit

否

String

返回条数。注意：offset和limit参数需要配套使用。

offset

否

String

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

order_column

否

String

按列排序，可设置为updated_at（按更新时间排序）。注意：order_column和order_type参数需要配套使用。

order_type

否

String

排序类型，可设置为desc（降序）、asc（升序）。注意：order_column和order_type参数需要配套使用。

filter

否

String

应填写 center::{center}|name::{name}|limit::{limit}|offset::{offset}|namespace::{namespace}|order_column::{order_column}|order_type::{order_type} ,其中 {center}可选为self: 我共享的镜像。thirdparty: 他人共享给我的镜像，namespace为组织名称，name为镜像仓库名称， {limit}为返回条数,{offset}为起始索引,{order_column}为按列排序，可设置为name、updated_time、tag_count,{order_type}为排序类型，可设置为desc（降序）、asc（升序）

请求消息

  • 请求参数

    无

  • 请求样例 
    GET https://{Endpoint}/v2/manage/shared-repositories?filter=center::self|name::busybox

响应消息

  • 响应参数
    表2 请求Header参数

    参数

    是否必选

    参数类型

    描述

    Content-Type

    是

    String

    消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json

    缺省值：application/json

    X-Auth-Token

    是

    String

    用户Token。

    通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
    表3 Response Body参数说明

    参数

    参数类型

    描述

    [数组元素]

    Array of objects

    共享镜像列表
    表4 [数组元素]参数说明

    参数

    参数类型

    描述

    name

    String

    镜像仓库名称

    category

    String

    镜像仓库类型，取值为app_server、linux、framework_app、database、lang、other、arm。

    description

    String

    镜像仓库描述

    size

    Integer

    镜像仓库中镜像总大小

    is_public

    Boolean

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

    num_images

    Integer

    镜像仓库下镜像版本数量

    num_download

    Integer

    下载次数

    created_at

    String

    镜像仓库创建时间，UTC日期格式，时间为UTC标准时间。

    updated_at

    String

    镜像仓库更新时间，UTC日期格式，时间为UTC标准时间。

    logo

    String

    镜像仓库logo地址（预留）

    url

    String

    镜像仓库logo图片的url地址（预留）

    path

    String

    集群外部docker pull地址，格式为{Repository address}/{Namespace name}/{Repository name}。

    internal_path

    String

    集群内部docker pull地址，格式为{Repository address}/{Namespace name}/{Repository name}。

    domain_name

    String

    账号名

    namespace

    String

    组织名称

    tags

    Array of strings

    镜像版本列表

    status

    Boolean
    • 查询他人共享镜像：共享是否过期
    • 查询我共享的镜像：默认为false，无意义

    total_range

    Integer

    总记录条数
  • 响应样例 
    [
    {
        "name": "busybox",
        "category": "other",
        "description": "",
        "size": 115645792,
        "is_public": false,
        "num_images": 1,
        "num_download": 0,
        "created_at": "2021-06-02T09:23:01.751202Z",
        "updated_at": "2021-06-10T07:24:35.204517Z",
        "logo": "",
        "url": "",
        "path": "{Repository address}/group/busybox",
        "internal_path": "{Repository address}/group/busybox",
        "domain_name": "domain",
        "namespace": "namespace",
        "tags": [
            "v1",
            "v2"
        ],
        "status": true,
        "total_range": 1
    }
]

状态码

状态码

描述

200

请求成功

400

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

401

鉴权失败的报错信息

500

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

错误码

请参见错误码。

父主题： 镜像仓库管理