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

获取镜像共享规则详情 - ShowRepoShare

功能介绍

获取镜像共享规则详情

接口约束

无

调用方法

请参见如何调用API。

授权信息

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

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

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    swr:repo:getRepoShare

    Read

    repo *

    -

    -

    -

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

namespace

是

String

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

repository

是

String

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

share_id

是

String

镜像共享规则ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

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

application/json;charset=utf-8

application/json

X-Auth-Token

是

String

用户Token。

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

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

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/{share_id}

响应示例

状态码：200

{
  "id" : "1",
  "namespace" : "nsname",
  "repository" : "paas",
  "share_type" : "organization",
  "share_principals" : [ "organizations::19ae87f6919c44bca6596733264666d9:ou:o-ahjlk5emc2c9vi8fzpvps3hafuf425e5/ou-g2p6cwqrj5x6agbswzrmgyvncz6e9f2w" ],
  "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

内部错误

错误码

请参见错误码。

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

相关文档