文档首页/ 容器镜像服务 SWR/ API参考(基础版)/ API/ 共享账号管理/ 判断共享账号是否存在 - ShowAccessDomain
更新时间:2026-09-28 GMT+08:00
分享

判断共享账号是否存在 - ShowAccessDomain

功能介绍

判断共享租户是否存在

接口约束

无

调用方法

请参见如何调用API。

授权信息

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

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

namespace

是

String

参数解释:

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

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

repository

是

String

参数解释:

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

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

access_domain

是

String

参数解释:

共享账号名称。用于唯一标识一个共享账号。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表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参数

参数

参数类型

描述

exist

Boolean

参数解释:

true:存在;false:不存在。

取值范围:

  • true:存在

  • false:不存在

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标准时间。格式为yyyy-MM-ddTHH:mm:ssZ,例如2021-06-10T08:14:42.56632Z。

取值范围:

不涉及。

updated

String

参数解释:

共享账号的更新时间,UTC时间格式,时间为UTC标准时间。格式为yyyy-MM-ddTHH:mm:ssZ,例如2021-06-10T08:14:42.566325Z。

取值范围:

不涉及。

status

Boolean

参数解释:

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

取值范围:

  • true:有效

  • false:过期

请求示例

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

响应示例

状态码:200

{
  "exist" : true,
  "namespace" : "group",
  "repository" : "busybox",
  "access_domain" : "xxx",
  "permit" : "read",
  "deadline" : "2021-10-01T16:00:00Z",
  "description" : "description",
  "creator_id" : "0504186e6a8010e01f3ec009a7279baa",
  "creator_name" : "xxx",
  "created" : "2021-06-10T08:14:42.56632Z",
  "updated" : "2021-06-10T08:14:42.566325Z",
  "status" : true
}

状态码

状态码

描述

200

查询成功

400

错误的请求

401

鉴权失败

500

内部错误

错误码

请参见错误码。

相关文档