> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Cache de imagens

> Mantenha imagens da origem em cache na conta e controle o acesso por IAM.

Uma regra de cache associa um prefixo de repositório da conta a um registry de origem. Por exemplo, o prefixo `hub` com origem `docker.io` e prefixo de origem `library` permite baixar `hub/nginx:stable` pela URI do Registry da conta:

```bash theme={null}
docker pull cr.sa-saopaulo-1.basaltic.cloud/my-account/hub/nginx:1.27
```

A regra fornece o namespace `library`, omitido da referência da imagem. Use outra regra com o prefixo apropriado para imagens de outros namespaces do Docker Hub.

Crie uma regra com `POST /v1/pull-through-cache-rules`. Os campos obrigatórios são `prefix` e `upstream_registry`. A resposta retorna `uri_prefix`; acrescente o restante do nome e a tag da imagem. Prefixos podem conter um ou dois componentes de nome de repositório.

<span id="credentials" />

## Credenciais

Para origem autenticada, forneça `upstream_username` e `upstream_secret`. O segredo é somente para escrita; leituras retornam `has_credential`. PATCH preserva campos omitidos. Para remover credenciais, envie usuário e segredo vazios juntos.

Somente destinos públicos de origem compatíveis são aceitos. Disponibilidade, credenciais e limites ainda afetam buscas sem cache. O recurso não permite acesso a endpoints de rede privada.

<span id="permissions-and-ownership" />

## Permissões e propriedade

Importar sem cache exige `registry:BatchImportUpstreamImage` além das ações de pull. Um leitor sem essa permissão pode usar imagens já armazenadas, mas não iniciar importações. O conteúdo importado consome armazenamento da conta e segue suas cotas e regras de ciclo de vida.

Gerencie regras pelo prefixo em `/v1/pull-through-cache-rules/{prefix}`. Excluir uma regra interrompe novas importações por ela; não remove repositórios ou imagens importadas. Revise essas imagens separadamente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.