- 启用 Debian 群组 API
- 验证到 Debian 发行版 API
- 列出群组中的所有 Debian 发行版
- 单个 Debian 群组发行版
- 单个 Debian 群组发行版密钥
- 创建一个 Debian 群组发行版
- 更新一个 Debian 群组发行版
- 删除一个 Debian 群组发行版
{{< details >}}
- Tier: 基础版,专业版,旗舰版
- Offering: 私有化部署
{{< /details >}}
{{< history >}}
- 部署在功能标志后,默认禁用。
{{< /history >}}
这是 Debian 群组发行版 API 的参考文档。此 API 在默认情况下被禁用的特性标志后面。要使用此 API,您必须启用它。
{{< alert type=”warning” >}}
此 API 正在开发中,不适用于生产环境。
{{< /alert >}}
有关使用 Debian 软件包的更多信息,请参阅Debian 软件包注册表文档。
启用 Debian 群组 API
Debian 群组存储库支持仍在进行中。它被默认禁用的特性标志所限制。拥有极狐GitLab Rails 控制台访问权限的管理员可以选择启用它。要启用它,请按照启用 Debian 群组 API中的说明进行操作。
验证到 Debian 发行版 API
列出群组中的所有 Debian 发行版
列出给定群组中的 Debian 发行版。
GET /groups/:id/-/debian_distributions
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
integer/string | 是 | 群组的 ID 或 URL 编码路径。 |
codename |
string | 否 | 使用特定 codename 进行过滤。 |
suite |
string | 否 | 使用特定 suite 进行过滤。 |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions"
示例响应:
[
{
"id": 1,
"codename": "sid",
"suite": null,
"origin": null,
"label": null,
"version": null,
"description": null,
"valid_time_duration_seconds": null,
"components": [
"main"
],
"architectures": [
"all",
"amd64"
]
}
]
单个 Debian 群组发行版
获取单个 Debian 群组发行版。
GET /groups/:id/-/debian_distributions/:codename
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
integer/string | 是 | 群组的 ID 或 URL 编码路径。 |
codename |
string | 是 | 发行版的 codename 。 |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable"
示例响应:
{
"id": 1,
"codename": "sid",
"suite": null,
"origin": null,
"label": null,
"version": null,
"description": null,
"valid_time_duration_seconds": null,
"components": [
"main"
],
"architectures": [
"all",
"amd64"
]
}
单个 Debian 群组发行版密钥
获取单个 Debian 群组发行版密钥。
GET /groups/:id/-/debian_distributions/:codename/key.asc
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
integer/string | 是 | 群组的 ID 或 URL 编码路径。 |
codename |
string | 是 | 发行版的 codename 。 |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable/key.asc"
示例响应:
-----BEGIN PGP PUBLIC KEY BLOCK-----
Comment: Alice's OpenPGP certificate
Comment: https://www.ietf.org/id/draft-bre-openpgp-samples-01.html
mDMEXEcE6RYJKwYBBAHaRw8BAQdArjWwk3FAqyiFbFBKT4TzXcVBqPTB3gmzlC/U
b7O1u120JkFsaWNlIExvdmVsYWNlIDxhbGljZUBvcGVucGdwLmV4YW1wbGU+iJAE
ExYIADgCGwMFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQTrhbtfozp14V6UTmPy
MVUMT0fjjgUCXaWfOgAKCRDyMVUMT0fjjukrAPoDnHBSogOmsHOsd9qGsiZpgRnO
dypvbm+QtXZqth9rvwD9HcDC0tC+PHAsO7OTh1S1TC9RiJsvawAfCPaQZoed8gK4
OARcRwTpEgorBgEEAZdVAQUBAQdAQv8GIa2rSTzgqbXCpDDYMiKRVitCsy203x3s
E9+eviIDAQgHiHgEGBYIACAWIQTrhbtfozp14V6UTmPyMVUMT0fjjgUCXEcE6QIb
DAAKCRDyMVUMT0fjjlnQAQDFHUs6TIcxrNTtEZFjUFm1M0PJ1Dng/cDW4xN80fsn
0QEA22Kr7VkCjeAEC08VSTeV+QFsmz55/lntWkwYWhmvOgE=
=iIGO
-----END PGP PUBLIC KEY BLOCK-----
创建一个 Debian 群组发行版
创建一个 Debian 群组发行版。
POST /groups/:id/-/debian_distributions
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
integer/string | 是 | 群组的 ID 或 URL 编码路径。 |
codename |
string | 是 | Debian 发行版的 codename。 |
suite |
string | 否 | 新 Debian 发行版的 suite。 |
origin |
string | 否 | 新 Debian 发行版的 origin。 |
label |
string | 否 | 新 Debian 发行版的 label。 |
version |
string | 否 | 新 Debian 发行版的 version。 |
description |
string | 否 | 新 Debian 发行版的 description。 |
valid_time_duration_seconds |
integer | 否 | 新 Debian 发行版的有效时间(以秒为单位)。 |
components |
string array | 否 | 新 Debian 发行版的组件列表。 |
architectures |
string array | 否 | 新 Debian 发行版的架构列表。 |
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions?codename=sid"
示例响应:
{
"id": 1,
"codename": "sid",
"suite": null,
"origin": null,
"label": null,
"version": null,
"description": null,
"valid_time_duration_seconds": null,
"components": [
"main"
],
"architectures": [
"all",
"amd64"
]
}
更新一个 Debian 群组发行版
更新一个 Debian 群组发行版。
PUT /groups/:id/-/debian_distributions/:codename
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
integer/string | 是 | 群组的 ID 或 URL 编码路径。 |
codename |
string | 是 | Debian 发行版的新 codename。 |
suite |
string | 否 | Debian 发行版的新 suite。 |
origin |
string | 否 | Debian 发行版的新 origin。 |
label |
string | 否 | Debian 发行版的新 label。 |
version |
string | 否 | Debian 发行版的新 version。 |
description |
string | 否 | Debian 发行版的新 description。 |
valid_time_duration_seconds |
integer | 否 | Debian 发行版的新有效时间(以秒为单位)。 |
components |
string array | 否 | Debian 发行版的新组件列表。 |
architectures |
string array | 否 | Debian 发行版的新架构列表。 |
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable?suite=new-suite&valid_time_duration_seconds=604800"
示例响应:
{
"id": 1,
"codename": "sid",
"suite": "new-suite",
"origin": null,
"label": null,
"version": null,
"description": null,
"valid_time_duration_seconds": 604800,
"components": [
"main"
],
"architectures": [
"all",
"amd64"
]
}
删除一个 Debian 群组发行版
删除一个 Debian 群组发行版。
DELETE /groups/:id/-/debian_distributions/:codename
属性 | 类型 | 必需 | 描述 |
---|---|---|---|
id |
integer/string | 是 | 群组的 ID 或 URL 编码路径。 |
codename |
string | 是 | Debian 发行版的 codename。 |
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/-/debian_distributions/unstable"