ContextQMD
Back to Gitlabhq

API des distributions de projet Debian

doc-locale/fr-fr/api/packages/debian_project_distributions.md

19.1.09.7 KB
Original Source

{{< details >}}

  • Édition : Gratuite, GitLab Premium, GitLab Ultimate
  • Offre : GitLab Self-Managed

{{< /details >}}

{{< history >}}

{{< /history >}}

Utilisez cette API pour gérer les distributions de projet Debian. Cette API est derrière un feature flag qui est désactivé par défaut. Pour utiliser cette API, vous devez activer l'API Debian.

[!warning] Cette API est en cours de développement et n'est pas destinée à une utilisation en production.

Activer l'API Debian {#enable-the-debian-api}

L'API Debian est derrière un feature flag qui est désactivé par défaut. Les administrateurs GitLab ayant accès à la console Rails de GitLab peuvent choisir de l'activer. Pour l'activer, suivez les instructions dans Activer l'API Debian.

S'authentifier auprès des API de distributions Debian {#authenticate-to-the-debian-distributions-apis}

Voir S'authentifier auprès des API de distributions Debian.

Répertorier toutes les distributions Debian dans un projet {#list-all-debian-distributions-in-a-project}

Répertorie toutes les distributions Debian pour un projet spécifié.

plaintext
GET /projects/:id/debian_distributions
AttributTypeObligatoireDescription
identier ou chaîneouiL'ID ou le chemin encodé en URL du projet.
codenamestringnonFiltrer avec un codename spécifique.
suitestringnonFiltrer avec un suite spécifique.
shell
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/debian_distributions"

Exemple de réponse :

json
[
  {
    "id": 1,
    "codename": "sid",
    "suite": null,
    "origin": null,
    "label": null,
    "version": null,
    "description": null,
    "valid_time_duration_seconds": null,
    "components": [
      "main"
    ],
    "architectures": [
      "all",
      "amd64"
    ]
  }
]

Récupérer une distribution de projet Debian {#retrieve-a-debian-project-distribution}

Récupère une distribution de projet Debian spécifiée pour un projet.

plaintext
GET /projects/:id/debian_distributions/:codename
AttributTypeObligatoireDescription
identier ou chaîneouiL'ID ou le chemin encodé en URL du projet.
codenamestringouiLe codename d'une distribution.
shell
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/debian_distributions/unstable"

Exemple de réponse :

json
{
  "id": 1,
  "codename": "sid",
  "suite": null,
  "origin": null,
  "label": null,
  "version": null,
  "description": null,
  "valid_time_duration_seconds": null,
  "components": [
    "main"
  ],
  "architectures": [
    "all",
    "amd64"
  ]
}

Récupérer une clé de distribution de projet Debian {#retrieve-a-debian-project-distribution-key}

Récupère une clé de distribution de projet Debian spécifiée pour un projet.

plaintext
GET /projects/:id/debian_distributions/:codename/key.asc
AttributTypeObligatoireDescription
identier ou chaîneouiL'ID ou le chemin encodé en URL du projet.
codenamestringouiLe codename d'une distribution.
shell
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/debian_distributions/unstable/key.asc"

Exemple de réponse :

plaintext
-----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-----

Créer une distribution de projet Debian {#create-a-debian-project-distribution}

Crée une distribution de projet Debian pour un projet spécifié.

plaintext
POST /projects/:id/debian_distributions
AttributTypeObligatoireDescription
identier ou chaîneouiL'ID ou le chemin encodé en URL du projet.
codenamestringouiLe nom de code de la distribution Debian.
suitestringnonLa suite de la nouvelle distribution Debian.
originstringnonL'origine de la nouvelle distribution Debian.
labelstringnonLe label de la nouvelle distribution Debian.
versionstringnonLa version de la nouvelle distribution Debian.
descriptionstringnonLa description de la nouvelle distribution Debian.
valid_time_duration_secondsentiernonLa durée de validité de la nouvelle distribution Debian (en secondes).
componentstableau de chaînesnonLa liste des composants de la nouvelle distribution Debian.
architecturestableau de chaînesnonLa liste des architectures de la nouvelle distribution Debian.
shell
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/debian_distributions?codename=sid"

Exemple de réponse :

json
{
  "id": 1,
  "codename": "sid",
  "suite": null,
  "origin": null,
  "label": null,
  "version": null,
  "description": null,
  "valid_time_duration_seconds": null,
  "components": [
    "main"
  ],
  "architectures": [
    "all",
    "amd64"
  ]
}

Mettre à jour une distribution de projet Debian {#update-a-debian-project-distribution}

Met à jour une distribution de projet Debian spécifiée pour un projet.

plaintext
PUT /projects/:id/debian_distributions/:codename
AttributTypeObligatoireDescription
identier ou chaîneouiL'ID ou le chemin encodé en URL du projet.
codenamestringouiLe nom de code de la distribution Debian.
suitestringnonLa nouvelle suite de la distribution Debian.
originstringnonLa nouvelle origine de la distribution Debian.
labelstringnonLe nouveau label de la distribution Debian.
versionstringnonLa nouvelle version de la distribution Debian.
descriptionstringnonLa nouvelle description de la distribution Debian.
valid_time_duration_secondsentiernonLa nouvelle durée de validité de la distribution Debian (en secondes).
componentstableau de chaînesnonLa nouvelle liste des composants de la distribution Debian.
architecturestableau de chaînesnonLa nouvelle liste des architectures de la distribution Debian.
shell
curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/debian_distributions/unstable?suite=new-suite&valid_time_duration_seconds=604800"

Exemple de réponse :

json
{
  "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"
  ]
}

Supprimer une distribution de projet Debian {#delete-a-debian-project-distribution}

Supprime une distribution de projet Debian spécifiée pour un projet.

plaintext
DELETE /projects/:id/debian_distributions/:codename
AttributTypeObligatoireDescription
identier ou chaîneouiL'ID ou le chemin encodé en URL du projet.
codenamestringouiLe nom de code de la distribution Debian.
shell
curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/debian_distributions/unstable"