Репозитории
Репозитории, которые видит вызывающий, и сведения об одном из них.
Операции этой группы с правилом доступа, правилом повтора, параметрами и ответами. Каждый запрос несёт ключ: Authorization: Bearer <ключ> (см. «Аутентификация»).
Операции
Перечислить доступные вам репозитории
GET HEAD /api/v1/repositories
Доступ: Репозитории, которые видит вызывающий (repository.read) · Повтор: Можно повторять (чтение)
Перечисляет в порядке имён репозитории, в которых у вызывающего есть право, с их форматами (upack, assets) и собственными правами вызывающего в них; управляемый ключ сервиса видит только те, где у него есть repository.read. Репозиторий — это область действия выданных вызывающему прав, а не запись общесерверного реестра. Страницы содержат limit карточек (1–100, по умолчанию 50); продолжайте с after, равным next.
Параметры
| Имя | Где | Тип | Обязателен | Правила |
|---|---|---|---|---|
after | запрос | string | нет | по шаблону ^[a-z0-9][a-z0-9_-]{0,63}$; Exclusive repository ID boundary; authorization is rechecked on every page. |
limit | запрос | integer | нет | 1–100; по умолчанию 50 |
Ответ 200
| Поле | Тип | Обязателен | Правила |
|---|---|---|---|
items | массив object | да | не больше 100 элементов |
items[].id | string | да | по шаблону ^[a-z0-9][a-z0-9_-]{0,63}$ |
items[].formats | массив string | да | 2–2 элементов; без повторов; каждый элемент: одно из upack, assets |
items[].permissions | массив string | да | 1–24 элементов; без повторов; каждый элемент: одно из 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 | да | по шаблону ^[a-z0-9][a-z0-9_-]{0,63}$; может быть null |
Ответы: 200, 400, 401, 403, 404, 409, 422, 503, 507
Пример
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
-H "Authorization: Bearer $ARKVORY_TOKEN"Получить карточку репозитория
GET HEAD /api/v1/repositories/{repository}
Доступ: Репозитории, которые видит вызывающий (repository.read) · Повтор: Можно повторять (чтение)
Возвращает карточку репозитория для вызывающего: его форматы и права вызывающего в нём. Репозиторий, который вызывающий не видит, отвечает 404 — так же, как несуществующий; HEAD делает это дешёвой проверкой доступа. Видимость репозитория не даёт доступа к его содержимому и настройкам.
Параметры
| Имя | Где | Тип | Обязателен | Правила |
|---|---|---|---|---|
repository | путь | string | да | по шаблону ^[a-z0-9][a-z0-9_-]{0,63}$ |
Ответ 200
| Поле | Тип | Обязателен | Правила |
|---|---|---|---|
id | string | да | по шаблону ^[a-z0-9][a-z0-9_-]{0,63}$ |
formats | массив string | да | 2–2 элементов; без повторов; каждый элемент: одно из upack, assets |
permissions | массив string | да | 1–24 элементов; без повторов; каждый элемент: одно из 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 |
Ответы: 200, 400, 401, 403, 404, 409, 422, 503, 507
Пример
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
-H "Authorization: Bearer $ARKVORY_TOKEN"