{{< 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 发行版 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"