> ## 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.

# Caché de imágenes

> Mantenga imágenes del origen en caché en la cuenta y controle el acceso mediante IAM.

Una regla de caché asocia un prefijo de repositorio de la cuenta a un registry de origen. Por ejemplo, el prefijo `hub` con origen `docker.io` y prefijo de origen `library` permite descargar `hub/nginx:stable` mediante la URI de Registry de la cuenta:

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

La regla proporciona el namespace `library`, omitido en la referencia de imagen. Use otra regla con el prefijo adecuado para imágenes de otros namespaces de Docker Hub.

Cree una regla con `POST /v1/pull-through-cache-rules`. Los campos obligatorios son `prefix` y `upstream_registry`. La respuesta devuelve `uri_prefix`; añada el resto del nombre y la etiqueta de imagen. Los prefijos pueden contener uno o dos componentes de nombre de repositorio.

<span id="credentials" />

## Credenciales

Para un origen autenticado, proporcione `upstream_username` y `upstream_secret`. El secreto es de solo escritura; las lecturas devuelven `has_credential`. PATCH conserva los campos omitidos. Para eliminar credenciales, envíe usuario y secreto vacíos juntos.

Solo se aceptan destinos públicos de origen compatibles. La disponibilidad, credenciales y límites siguen afectando a búsquedas sin caché. La función no permite acceso a endpoints de red privada.

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

## Permisos y propiedad

Importar sin caché exige `registry:BatchImportUpstreamImage` además de las acciones de pull. Un lector sin ese permiso puede usar imágenes ya almacenadas, pero no iniciar importaciones. El contenido importado consume almacenamiento de la cuenta y sigue sus cuotas y reglas de ciclo de vida.

Administre reglas por prefijo en `/v1/pull-through-cache-rules/{prefix}`. Eliminar una regla detiene nuevas importaciones mediante ella; no elimina repositorios ni imágenes importadas. Revise esas imágenes por separado.


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