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

# Permisos de Registry

> Conceda pull, push y administración por separado.

Los recursos de Registry pertenecen a la cuenta y región. Los CRN de repositorio usan `crn:registry:sa-saopaulo-1:my-account:repository/team/api`. Las reglas de caché usan el tipo de recurso `pull-through-cache-rule`.

<span id="container-client-permissions" />

## Permisos de clientes de contenedores

Obtener una credencial exige `registry:GetAuthorizationToken`. Pull también exige `registry:ListImages`, `registry:BatchGetImage` y `registry:GetDownloadUrlForLayer` en el repositorio. La credencial de inicio de sesión por sí sola no concede acceso a las imágenes.

Push añade `registry:InitiateLayerUpload`, `registry:UploadLayerPart`, `registry:CompleteLayerUpload` y `registry:PutImage`. Importar del origen sin caché también exige `registry:BatchImportUpstreamImage`. Las políticas de recurso pueden conceder acceso a otros principales; las denegaciones explícitas siguen aplicándose. Separe la administración de las identidades de compilación y ejecución.

<span id="control-plane-actions" />

## Acciones de administración

| Acción | Llamadas de la API |
| - | - |
| `registry:BatchDeleteImage` | `POST /v1/repositories/{repository_id}/images/batch-delete` |
| `registry:BatchGetImage` | `GET /v1/repositories/{repository_id}/images/{image_reference}` |
| `registry:CreatePullThroughCacheRule` | `POST /v1/pull-through-cache-rules` |
| `registry:CreateRepository` | `POST /v1/repositories` |
| `registry:DeleteLifecyclePolicy` | `DELETE /v1/repositories/{repository_id}/lifecycle-policy` |
| `registry:DeletePullThroughCacheRule` | `DELETE /v1/pull-through-cache-rules/{prefix}` |
| `registry:DeleteRepository` | `DELETE /v1/repositories/{repository_id}` |
| `registry:DeleteRepositoryPolicy` | `DELETE /v1/repositories/{repository_id}/policy` |
| `registry:DescribeImages` | `GET /v1/repositories/{repository_id}/images` |
| `registry:DescribePullThroughCacheRules` | `GET /v1/pull-through-cache-rules`<br />`GET /v1/pull-through-cache-rules/{prefix}` |
| `registry:DescribeRepositories` | `GET /v1/repositories`<br />`GET /v1/repositories/{repository_id}` |
| `registry:GetAuthorizationToken` | `POST /v1/authorization-token` |
| `registry:GetEncryptionConfiguration` | `GET /v1/encryption-configuration/retained-data`<br />`GET /v1/encryption-configuration` |
| `registry:GetLifecyclePolicy` | `GET /v1/repositories/{repository_id}/lifecycle-policy` |
| `registry:GetRepositoryPolicy` | `GET /v1/repositories/{repository_id}/policy` |
| `registry:ListImages` | `GET /v1/repositories/{repository_id}/tags` |
| `registry:PutEncryptionConfiguration` | `DELETE /v1/encryption-configuration`<br />`PUT /v1/encryption-configuration` |
| `registry:PutLifecyclePolicy` | `PUT /v1/repositories/{repository_id}/lifecycle-policy` |
| `registry:SetRepositoryPolicy` | `PUT /v1/repositories/{repository_id}/policy` |
| `registry:StartLifecyclePolicyPreview` | `POST /v1/repositories/{repository_id}/lifecycle-policy/preview` |
| `registry:UpdatePullThroughCacheRule` | `PATCH /v1/pull-through-cache-rules/{prefix}` |
| `registry:UpdateRepository` | `PATCH /v1/repositories/{repository_id}` |

<span id="example-pull-one-repository" />

## Ejemplo: descargar de un repositorio

Esta política de identidad concede una credencial de inicio de sesión y acceso a un repositorio:

```json theme={null}
{
  "version": "2024-01-01",
  "statements": [
    {"effect":"allow","actions":["registry:GetAuthorizationToken"],"resources":["*"]},
    {"effect":"allow","actions":["registry:ListImages","registry:BatchGetImage","registry:GetDownloadUrlForLayer"],"resources":["crn:registry:sa-saopaulo-1:my-account:repository/team/api"]}
  ]
}
```

Añada creación, modificación, eliminación, políticas de recurso o ciclo de vida solo cuando la identidad lo necesite. El cifrado de la cuenta usa la acción separada `registry:PutEncryptionConfiguration`.


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