{{< 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"