文档首页/ 容器镜像服务 SWR/ API参考(基础版)/ API/ 共享账号管理/ 获取共享账号列表 - ListRepoDomains
更新时间:2026-09-28 GMT+08:00
分享

获取共享账号列表 - ListRepoDomains

功能介绍

获取共享账号列表

接口约束

无

调用方法

请参见如何调用API。

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains

表1 路径参数

参数

是否必选

参数类型

描述

namespace

是

String

参数解释:

组织名称。用于唯一标识一个组织,组织下的所有镜像仓库都属于该组织。

约束限制:

不涉及。

取值范围:

小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~64个字符。

默认取值:

不涉及。

repository

是

String

参数解释:

镜像仓库名称过滤关键字,用于模糊匹配镜像仓库列表。与精确匹配的name参数不同,filter支持模糊查询。

约束限制:

不涉及。

取值范围:

小写字母或数字开头,后面跟小写字母、数字、小数点、斜杠、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~128个字符。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释:

消息体的类型(格式),用于指定请求体的MIME类型。

约束限制:

不涉及。

取值范围:

  • application/json;charset=utf-8:使用UTF-8字符集的JSON格式

  • application/json:标准JSON格式

默认取值:

不涉及。

X-Auth-Token

是

String

参数解释:

用户Token。用于调用API时的鉴权。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

[数组元素]

Array of ShowRepoDomainsResponse objects

共享租户列表

表4 ShowRepoDomainsResponse

参数

参数类型

描述

namespace

String

参数解释:

组织。

取值范围:

小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~64个字符。

repository

String

参数解释:

镜像仓库。

取值范围:

小写字母或数字开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,不同类型分隔符不能直接相连),小写字母或数字结尾,长度1~128个字符。

access_domain

String

参数解释:

共享租户名。

取值范围:

长度1~128个字符,支持字母、数字、小数点、下划线、中划线、空格、@和中文。

permit

String

参数解释:

权限。

取值范围:

  • read:只读权限

deadline

String

参数解释:

截止时间,UTC时间格式,如2018-10-01T16:00:00.000Z;或forever表示永久有效。

取值范围:

不涉及。

description

String

参数解释:

描述。

取值范围:

最大256KB字节或30000个字符。

creator_id

String

参数解释:

创建者ID。

取值范围:

由字母、数字组成,长度1~65个字符

。

creator_name

String

参数解释:

创建者名称。

取值范围:

由中文字符、英文字母、数字及部分特殊字符组成,长度1~256个字符。

created

String

参数解释:

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

取值范围:

不涉及。

updated

String

参数解释:

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

取值范围:

不涉及。

status

Boolean

参数解释:

是否过期:true:有效;false:过期。

取值范围:

  • true:有效

  • false:过期

请求示例

GET https://{endpoint}/v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains

响应示例

状态码:200

[ {
  "namespace" : "huawei",
  "repository" : "paas",
  "access_domain" : "swr",
  "permit" : "read",
  "deadline" : "2018-10-01T16:00:00.000Z",
  "description" : "description",
  "creator_id" : "fb3f175c1fd146ab8cdae3272be6107b",
  "creator_name" : "huawei",
  "created" : "2017-04-08T14:12:23Z",
  "updated" : "2017-04-13T21:01:11Z",
  "status" : false
} ]

状态码

状态码

描述

200

成功查询共享账号列表

400

错误的请求

401

鉴权失败

500

内部错误

错误码

请参见错误码。

相关文档