Repositórios
Os repositórios que um chamador pode ver e os detalhes de cada um.
Operações deste grupo com a regra de acesso, a regra de repetição, os parâmetros e as respostas. Toda solicitação leva uma chave: Authorization: Bearer <chave> (consulte “Autenticação”).
Operações
Listar os repositórios aos quais você tem acesso
GET HEAD /api/v1/repositories
Acesso: Repositórios que o chamador pode ver (repository.read) · Repetição: Pode ser repetida com segurança (leitura)
Lista, ordenados por nome, os repositórios nos quais o chamador tem alguma permissão, cada um com seus formatos (upack, assets) e as permissões do próprio chamador nele; uma chave de serviço gerenciada vê apenas aqueles em que tem repository.read. Um repositório é o escopo das concessões do chamador, não uma entrada de um registro global do servidor. As páginas contêm limit fichas (1–100, padrão 50); continue com after definido como next.
Parâmetros
| Nome | Local | Tipo | Obrigatório | Regras |
|---|---|---|---|---|
after | consulta | string | não | corresponde a ^[a-z0-9][a-z0-9_-]{0,63}$; Exclusive repository ID boundary; authorization is rechecked on every page. |
limit | consulta | integer | não | 1–100; padrão 50 |
Resposta 200
| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
items | array de object | sim | até 100 itens |
items[].id | string | sim | corresponde a ^[a-z0-9][a-z0-9_-]{0,63}$ |
items[].formats | array de string | sim | 2–2 itens; sem itens repetidos; cada item: um destes: upack, assets |
items[].permissions | array de string | sim | 1–24 itens; sem itens repetidos; cada item: um destes: 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 | sim | corresponde a ^[a-z0-9][a-z0-9_-]{0,63}$; pode ser null |
Respostas: 200, 400, 401, 403, 404, 409, 422, 503, 507
Exemplo
curl -X GET "$ARKVORY_URL/api/v1/repositories" \
-H "Authorization: Bearer $ARKVORY_TOKEN"Obter a ficha de um repositório
GET HEAD /api/v1/repositories/{repository}
Acesso: Repositórios que o chamador pode ver (repository.read) · Repetição: Pode ser repetida com segurança (leitura)
Retorna a ficha de um repositório para o chamador: seus formatos e as permissões do chamador nele. Um repositório que o chamador não pode ver responde 404, exatamente como um que não existe; HEAD torna isso uma verificação de acesso barata. Ver um repositório não concede acesso ao seu conteúdo nem às suas configurações.
Parâmetros
| Nome | Local | Tipo | Obrigatório | Regras |
|---|---|---|---|---|
repository | caminho | string | sim | corresponde a ^[a-z0-9][a-z0-9_-]{0,63}$ |
Resposta 200
| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
id | string | sim | corresponde a ^[a-z0-9][a-z0-9_-]{0,63}$ |
formats | array de string | sim | 2–2 itens; sem itens repetidos; cada item: um destes: upack, assets |
permissions | array de string | sim | 1–24 itens; sem itens repetidos; cada item: um destes: 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 |
Respostas: 200, 400, 401, 403, 404, 409, 422, 503, 507
Exemplo
curl -X GET "$ARKVORY_URL/api/v1/repositories/$REPOSITORY" \
-H "Authorization: Bearer $ARKVORY_TOKEN"