4.7.1 创建镜像权限
功能介绍
创建镜像权限
接口约束
需要组织权限为编辑以上，或者镜像仓库权限为管理，才可为其他用户（不包括自 身）授权。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/manage/namespaces/{namespace}/repos/{repository}/access
表4-79 路径参数
参数 是否必选 参数类型 描述
namespace 是 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下 划线或中划线（其中下划线最多 允许连续两个，小数点、下划 线、中划线不能直接相连），小 写字母或数字结尾，1-64个字 符。
参数 是否必选 参数类型 描述
repository 是 String 镜像仓库名称
请求参数
表4-80 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
表4-81 请求 Body 参数
参数 是否必选 参数类型 描述
[数组元素] 是 Array of UserAuth objects
需要创建镜像权限的信息
表4-82 UserAuth
参数 是否必选 参数类型 描述
user_id 是 String 用户id，需要从IAM服务获取 user_name 是 String 用户名，需要从IAM服务获取
auth 是 Long 用户权限，7表示管理权限，3
表示编辑权限，1表示读取权限
响应参数
无
请求示例
POST https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/access
[ { "user_id" : "fb3f175c1fd146ab8cdae3272be6107b", "user_name" : "user01",
"auth" : 1 } ]
响应示例
无
状态码
状态码 描述
201 创建成功
400 错误的请求
401 鉴权失败
404 镜像不存在
500 内部错误
错误码
请参见错误码。
4.7.2 删除镜像权限
功能介绍
删除镜像权限
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/access
表4-83 路径参数
参数 是否必选 参数类型 描述
namespace 是 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下
repository 是 String 镜像仓库名称
请求参数
表4-84 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户
strings 用户ID，需从华为云IAM服务获 取。
响应参数
无
请求示例
DELETE https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/access
响应示例
无
状态码
状态码 描述
204 删除成功
400 错误的请求
401 鉴权失败
404 镜像不存在
500 内部错误
错误码
请参见错误码。
4.7.3 更新镜像权限
功能介绍
更新镜像权限
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/access
表4-86 路径参数
参数 是否必选 参数类型 描述
namespace 是 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下 划线或中划线（其中下划线最多 允许连续两个，小数点、下划 线、中划线不能直接相连），小 写字母或数字结尾，1-64个字 符。
repository 是 String 镜像仓库名称
请求参数
表4-87 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
表4-88 请求 Body 参数
参数 是否必选 参数类型 描述
[数组元素] 是 Array of UserAuth objects
需要创建镜像权限的信息
表4-89 UserAuth
参数 是否必选 参数类型 描述
user_id 是 String 用户id，需要从IAM服务获取 user_name 是 String 用户名，需要从IAM服务获取
auth 是 Long 用户权限，7表示管理权限，3
表示编辑权限，1表示读取权限
响应参数
无
请求示例
PATCH https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/access [ { "user_id" : "fb3f175c1fd146ab8cdae3272be6107b",
"user_name" : "liugenping01", "auth" : 7
} ]
响应示例
无
状态码
状态码 描述
201 更新成功
400 错误的请求
401 鉴权失败
404 镜像不存在
500 内部错误
错误码
请参见错误码。
4.7.4 查询镜像权限
功能介绍
查询镜像权限
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/manage/namespaces/{namespace}/repos/{repository}/access
表4-90 路径参数
参数 是否必选 参数类型 描述
namespace 是 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下 划线或中划线（其中下划线最多 允许连续两个，小数点、下划 线、中划线不能直接相连），小 写字母或数字结尾，1-64个字 符。
参数 是否必选 参数类型 描述
repository 是 String 镜像仓库名称
请求参数
表4-91 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
响应参数
状态码： 200
表4-92 响应 Body 参数
参数 参数类型 描述
id Integer id
name String 组织名称。小写字母开头，后面跟小写字母、数 字、小数点、下划线或中划线（其中下划线最多 允许连续两个，小数点、下划线、中划线不能直 接相连），小写字母或数字结尾，1-64个字符。
self_auth UserAuth
object 本用户权限 others_auths Array of
UserAuth objects
其他用户的权限
表4-93 UserAuth
参数 参数类型 描述
user_id String 用户id，需要从IAM服务获取
参数 参数类型 描述
user_name String 用户名，需要从IAM服务获取
auth Long 用户权限，7表示管理权限，3表示编辑权限，1 表示读取权限
请求示例
GET https://{endpoint}/v2/manage/amespaces/{namespace}/repos/{repository}/access
响应示例
状态码： 200 查询成功
{ "id" : 1422, "name" : "group", "self_auth" : {
"user_id" : "3059e6b5562241fda3fa441cca6f228b", "user_name" : "liugenping",
"auth" : 7 }, "others_auths" : [ {
"user_id" : "fb3f175c1fd146ab8cdae3272be6107b", "user_name" : "liugenping01",
"auth" : 7 } ] }
状态码
状态码 描述
200 查询成功
400 错误的请求
401 鉴权失败
404 镜像不存在
500 内部错误
错误码
请参见错误码。