Dépôts
Les dépôts visibles par l’appelant et les détails de l’un d’eux.
Opérations de ce groupe, avec leur règle d’accès, leur règle de nouvelle tentative, leurs paramètres et leurs réponses. Chaque requête porte une clé : Authorization: Bearer <clé> (voir « Authentification »).
Opérations
Lister les dépôts accessibles
GET HEAD /api/v1/repositories
Accès: Dépôts visibles par l’appelant (repository.read) · Nouvelle tentative: Peut être répétée sans risque (lecture)
Liste, par ordre de nom, les dépôts dans lesquels l’appelant détient une autorisation, chacun avec ses formats (upack, assets) et les autorisations propres à l’appelant ; une clé de service gérée ne voit que ceux où elle détient repository.read. Un dépôt est le périmètre des autorisations accordées à l’appelant, et non une entrée d’un registre global du serveur. Les pages contiennent limit fiches (1–100, 50 par défaut) ; poursuivez avec after défini sur next.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Règles |
|---|---|---|---|---|
after | requête | string | non | correspond à ^[a-z0-9][a-z0-9_-]{0,63}$; Exclusive repository ID boundary; authorization is rechecked on every page. |
limit | requête | integer | non | 1–100; par défaut 50 |
Réponse 200
| Champ | Type | Obligatoire | Règles |
|---|---|---|---|
items | tableau de object | oui | jusqu’à 100 éléments |
items[].id | string | oui | correspond à ^[a-z0-9][a-z0-9_-]{0,63}$ |
items[].formats | tableau de string | oui | 2–2 éléments; aucun élément répété; chaque élément : une valeur parmi upack, assets |
items[].permissions | tableau de string | oui | 1–24 éléments; aucun élément répété; chaque élément : une valeur parmi repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read |
next | string | oui | correspond à ^[a-z0-9][a-z0-9_-]{0,63}$; peut être null |
Réponses: 200, 400, 401, 403, 404, 409, 422, 503, 507
Exemple
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
-H "Authorization: Bearer $ARKVORY_TOKEN"Obtenir la fiche d’un dépôt
GET HEAD /api/v1/repositories/{repository}
Accès: Dépôts visibles par l’appelant (repository.read) · Nouvelle tentative: Peut être répétée sans risque (lecture)
Renvoie la fiche de l’appelant pour un dépôt : ses formats et les autorisations de l’appelant. Un dépôt que l’appelant ne peut pas voir répond 404, exactement comme un dépôt inexistant ; HEAD en fait une vérification d’accès peu coûteuse. Voir un dépôt n’accorde aucun accès à son contenu ni à ses paramètres.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Règles |
|---|---|---|---|---|
repository | chemin | string | oui | correspond à ^[a-z0-9][a-z0-9_-]{0,63}$ |
Réponse 200
| Champ | Type | Obligatoire | Règles |
|---|---|---|---|
id | string | oui | correspond à ^[a-z0-9][a-z0-9_-]{0,63}$ |
formats | tableau de string | oui | 2–2 éléments; aucun élément répété; chaque élément : une valeur parmi upack, assets |
permissions | tableau de string | oui | 1–24 éléments; aucun élément répété; chaque élément : une valeur parmi repository.read, storage.read, storage.manage, diagnostics.read, artifact.read, artifact.list, artifact.delete, artifact.promote, content.read, upload.create, upload.read, upload.write, upload.complete, upload.cancel, job.read, package.read, package.publish, asset.read, asset.write, asset.restore, annotation.read, annotation.write, reference.write, audit.read |
Réponses: 200, 400, 401, 403, 404, 409, 422, 503, 507
Exemple
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
-H "Authorization: Bearer $ARKVORY_TOKEN"