文档首页/ 容器镜像服务 SWR/ API参考（基础版）/ API/ 镜像共享规则管理/ 获取镜像共享规则列表 - ListRepoShares
更新时间：2026-09-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取镜像共享规则列表 - ListRepoShares

功能介绍

获取镜像共享规则列表

接口约束

无

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    swr:repo:listRepoShares

    List

    repo *

    -

    -

    -

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/shares

表1 路径参数

参数

是否必选

参数类型

描述

namespace

是

String

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

repository

是

String

镜像仓库名称。小写字母或数字开头，后面跟小写字母、数字、小数点、斜杠、下划线或中划线（其中下划线最多允许连续两个，小数点、斜杠、下划线、中划线不能直接相连），小写字母或数字结尾，1-128个字符。如果您的镜像名称repository参数中有斜杠，请先替换成$再进行请求。
表2 Query参数

参数

是否必选

参数类型

描述

share_type

否

String

共享类型

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），下方类型可任选其一使用：

application/json;charset=utf-8

application/json

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

[数组元素]

Array of ShowRepoSharesResponse objects

共享列表
表5 ShowRepoSharesResponse

参数

参数类型

描述

id

String

ID

namespace

String

组织

repository

String

镜像仓库

share_type

String

共享类型。目前只支持account，organization

share_principals

Array of strings

被共享者的信息列表。

permission

String

权限

deadline

String

截止时间

description

String

描述

creator_id

String

创建者ID

creator_name

String

创建者名称

created

String

镜像创建时间，UTC时间格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00

updated

String

镜像更新时间，UTC时间格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00

status

Boolean

是否过期：true:有效；false:过期

请求示例

GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/shares

响应示例

状态码：200

[ {
  "id" : "1",
  "namespace" : "nsname",
  "repository" : "paas",
  "share_type" : "account",
  "share_principals" : [ "fb3f175c1fd146ab8cdae3272be6107b" ],
  "permission" : "read",
  "deadline" : "2018-10-01T16:00:00.000Z",
  "description" : "description",
  "creator_id" : "fb3f175c1fd146ab8cdae3272be6107b",
  "creator_name" : "creator",
  "created" : "2017-04-08T14:12:23Z",
  "updated" : "2017-04-13T21:01:11Z",
  "status" : false
} ]

状态码

状态码

描述

200

成功查询镜像共享规则列表

400

错误的请求

401

鉴权失败

500

内部错误

错误码

请参见错误码。

父主题： 镜像共享规则管理