As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Extrair uma imagem com uma regra de cache de pull-through no Amazon ECR
<a name="pull-through-cache-working-pulling"></a>

Os exemplos a seguir mostram a sintaxe do comando a ser usada ao extrair uma imagem usando uma regra de cache de pull- through. Se você receber um erro ao extrair uma imagem upstream usando uma regra de cache de pull-through, consulte [Solução de problemas de cache de pull-through no Amazon ECR](error-pullthroughcache.md) para ver os erros mais comuns e como resolvê-los.

Antes de começar a trabalhar com as regras de cache de pull-through, verifique se você tem as permissões adequadas do IAM. Para obter mais informações, consulte [Permissões do IAM necessárias para sincronizar um registro upstream com um registro privado do Amazon ECR](pull-through-cache-iam.md).

**nota**  
Os exemplos a seguir usam os valores de namespace padrão do repositório Amazon ECR que eles usam. Console de gerenciamento da AWS Certifique-se de usar o URI do repositório privado do Amazon ECR que você configurou.

## Para o Amazon ECR Public
<a name="w2aac28c31b9b1"></a>

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/ecr-public/repository_name/image_name:tag
```

## Registro de contêineres Kubernetes
<a name="w2aac28c31b9b3"></a>

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/kubernetes/repository_name/image_name:tag
```

## Quay
<a name="w2aac28c31b9b5"></a>

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/quay/repository_name/image_name:tag
```

## Docker Hub
<a name="w2aac28c31b9b7"></a>

Para imagens oficiais do Docker Hub:

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/docker-hub/library/image_name:tag
```

**nota**  
Para imagens oficiais do Docker Hub, o orefixo `/library` deve ser incluído. Para todos os outros repositórios do Docker Hub, você deve omitir o prefixo `/library`.

Para todas as outras imagens do Docker Hub:

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/docker-hub/repository_name/image_name:tag
```

## GitHub Registro de contêiner
<a name="w2aac28c31b9b9"></a>

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/github/repository_name/image_name:tag
```

## Microsoft Azure Container Registry
<a name="w2aac28c31b9c11"></a>

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/azure/repository_name/image_name:tag
```

## GitLab Registro de contêiner
<a name="w2aac28c31b9c13"></a>

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/gitlab/repository_name/image_name:tag
```

## Registro Chainguard
<a name="w2aac28c31b9c15"></a>

```
docker pull aws_account_id.dkr.ecr.region.amazonaws.com/chainguard/repository_name/image_name:tag
```