2.14. 软件仓库


列出、创建和管理存储库。

2.14.1. createRepo

创建新存储库。

POST /api/v1/repository

Authorizations: oauth2_implicit (repo:create)

请求正文模式(application/json)

新存储库的描述

Expand
名称描述模式

软件仓库
可选

仓库名称

字符串

可见性
可选

存储库将以其开头的可见性

字符串

namespace
可选

创建存储库的命名空间。如果省略,则使用调用者的用户名

字符串

description
可选

存储库的 Markdown 编码描述

字符串

repo_kind
optional

存储库的种类

 
响应
Expand
HTTP 代码描述模式

201

成功创建

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.14.2. listRepos

在各种情况下,获取当前用户可见的存储库列表。

GET /api/v1/repository

授权: oauth2_implicit (repo:read)

查询参数
Expand
类型Name描述模式

query

next_page
optional

下一页的页面令牌

字符串

query

repo_kind
optional

要返回的仓库类型

字符串

query

popularity
可选

是否包含存储库的流行度指标。

布尔值

query

last_modified
可选

是否包含存储库最后一次修改的时间。

布尔值

query

public
可选

通过看似公开的用户添加任何可见的软件仓库

布尔值

query

starred
可选

过滤用户返回到这些不足的存储库

布尔值

query

namespace
可选

过滤返回到此命名空间的存储库

字符串

响应
Expand
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.14.3. changeRepoVisibility

更改存储库的可见性。

POST /api/v1/repository/{repository}/changevisibility

授权: oauth2_implicit (repo:admin)

路径参数
Expand
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

请求正文模式(application/json)

更改存储库的可见性。

Expand
名称描述模式

可见性
可选

存储库将以其开头的可见性

字符串

响应
Expand
HTTP 代码描述模式

201

成功创建

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.14.4. changeRepoState

更改存储库的状态。

PUT /api/v1/repository/{repository}/changestate

授权: oauth2_implicit (repo:admin)

路径参数
Expand
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

请求正文模式(application/json)

更改存储库的状态。

Expand
名称描述模式

state
可选

确定是否允许推送。

字符串

响应
Expand
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.14.5. getRepo

获取指定的存储库。

GET /api/v1/repository/{repository}

授权: oauth2_implicit (repo:read)

路径参数
Expand
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

查询参数
Expand
类型Name描述模式

query

IncludeTags
可选

是否包含存储库标签

布尔值

query

includeStats
可选

是否包含操作统计

布尔值

响应
Expand
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.14.6. updateRepo

更新指定存储库中的描述。

PUT /api/v1/repository/{repository}

授权: oauth2_implicit (repo:write)

路径参数
Expand
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

请求正文模式(application/json)

可在存储库中更新的字段。

Expand
名称描述模式

description
可选

存储库的 Markdown 编码描述

字符串

响应
Expand
HTTP 代码描述模式

200

成功调用

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

2.14.7. deleteRepository

删除存储库。

DELETE /api/v1/repository/{repository}

授权: oauth2_implicit (repo:admin)

路径参数
Expand
类型Name描述模式

path

软件仓库
必需

存储库的完整路径。例如 namespace/name

字符串

响应
Expand
HTTP 代码描述模式

204

已删除

 

400

错误请求

ApiError

401

需要会话

ApiError

403

未授权访问

ApiError

404

未找到

ApiError

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat