更新时间:2024-04-19 GMT+08:00

创建共享账号

功能介绍

创建共享账号。镜像上传后,您可以共享私有镜像给其他账号,并授予下载该镜像的权限。

URI

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

参数说明请参见表1

表1 参数说明

参数名称

是否必选

参数类型

描述

namespace

String

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

repository

String

镜像仓库名称

请求消息

  • 请求参数
    表2 请求Header参数

    参数

    是否必选

    参数类型

    描述

    Content-Type

    String

    消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json

    缺省值:application/json

    X-Auth-Token

    String

    用户Token。

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

    表3 Request Body参数说明

    参数

    是否必选

    参数类型

    描述

    access_domain

    String

    共享账号名称

    permit

    String

    当前只支持read权限

    deadline

    String

    截止时间,UTC时间格式。永久有效为forever。截止时间按天过期,截止时间为第二天的00:00:00,未精确到分钟级别。

    description

    String

    描述

  • 请求样例
    POST https://{Endpoint}/v2/manage/namespaces/group/repositories/busybox/access-domains

    Body:

    {
        "access_domain": "domain_name",
        "permit": "read",
        "deadline": "2021-10-01T16:00:00.000Z",
        "description": "description"
    }

响应消息

  • 响应参数

  • 响应样例

状态码

状态码

描述

201

创建成功

400

错误的请求

401

鉴权失败

409

仓库共享已经存在

500

内部错误

错误码

请参见错误码