Repositorios
Los repositorios que el llamador puede ver y los detalles de cada uno.
Operaciones de este grupo con su regla de acceso, su regla de reintento, sus parámetros y sus respuestas. Cada solicitud lleva una clave: Authorization: Bearer <clave> (consulte «Autenticación»).
Operaciones
Listar los repositorios a los que tiene acceso
GET HEAD /api/v1/repositories
Acceso: Repositorios que el llamador puede ver (repository.read) · Reintento: Se puede repetir (lectura)
Enumera, ordenados por nombre, los repositorios en los que el solicitante tiene algún permiso, cada uno con sus formatos (upack, assets) y los permisos propios del solicitante en él; una clave de servicio administrada solo ve aquellos en los que tiene repository.read. Un repositorio es el ámbito de las concesiones del solicitante, no una entrada de un registro de todo el servidor. Las páginas contienen limit fichas (1–100, 50 por defecto); continúe pasando next como after.
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Reglas |
|---|---|---|---|---|
after | consulta | string | no | coincide con ^[a-z0-9][a-z0-9_-]{0,63}$; Exclusive repository ID boundary; authorization is rechecked on every page. |
limit | consulta | integer | no | 1–100; predeterminado: 50 |
Respuesta 200
| Campo | Tipo | Obligatorio | Reglas |
|---|---|---|---|
items | array de object | sí | hasta 100 elementos |
items[].id | string | sí | coincide con ^[a-z0-9][a-z0-9_-]{0,63}$ |
items[].formats | array de string | sí | 2–2 elementos; sin elementos repetidos; cada elemento: uno de upack, assets |
items[].permissions | array de string | sí | 1–24 elementos; sin elementos repetidos; cada elemento: uno de 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 | sí | coincide con ^[a-z0-9][a-z0-9_-]{0,63}$; puede ser null |
Respuestas: 200, 400, 401, 403, 404, 409, 422, 503, 507
Ejemplo
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
-H "Authorization: Bearer $ARKVORY_TOKEN"Obtener la ficha de un repositorio
GET HEAD /api/v1/repositories/{repository}
Acceso: Repositorios que el llamador puede ver (repository.read) · Reintento: Se puede repetir (lectura)
Devuelve la ficha de un repositorio para el solicitante: sus formatos y los permisos del solicitante en él. Un repositorio que el solicitante no puede ver responde 404, igual que uno que no existe; HEAD lo convierte en una comprobación de acceso barata. Ver un repositorio no concede acceso a su contenido ni a su configuración.
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Reglas |
|---|---|---|---|---|
repository | ruta | string | sí | coincide con ^[a-z0-9][a-z0-9_-]{0,63}$ |
Respuesta 200
| Campo | Tipo | Obligatorio | Reglas |
|---|---|---|---|
id | string | sí | coincide con ^[a-z0-9][a-z0-9_-]{0,63}$ |
formats | array de string | sí | 2–2 elementos; sin elementos repetidos; cada elemento: uno de upack, assets |
permissions | array de string | sí | 1–24 elementos; sin elementos repetidos; cada elemento: uno de 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 |
Respuestas: 200, 400, 401, 403, 404, 409, 422, 503, 507
Ejemplo
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
-H "Authorization: Bearer $ARKVORY_TOKEN"