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

创建镜像仓库

功能介绍

在组织下创建镜像仓库。

URI

POST /v2/manage/namespaces/{namespace}/repos

参数说明请参见表1

表1 参数说明

参数名称

是否必选

参数类型

描述

namespace

String

组织名称

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

请求参数

表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 请求Body参数

参数

是否必选

参数类型

描述

repository

String

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

is_public

Boolean

是否为公共仓库,可选值为true或false。

category

String

仓库类型,可设置为app_server, linux, framework_app, database, lang, other, arm。

description

String

镜像仓库的描述信息。

响应参数

请求示例

POST https://{endpoint}/v2/manage/namespaces/{namespace}/repos

{
  "repository" : "busybox",
  "category" : "linux",
  "description" : "this is a busybox repository",
  "is_public" : true
}

响应示例

状态码

状态码

描述

201

创建成功

400

错误请求,返回错误信息。

401

鉴权失败

409

repository已存在

500

服务器内部错误,返回错误信息。

错误码

请参见错误码