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á.
# Liste e visualize detalhes da fórmula de contêiner
Esta seção descreve as maneiras pelas quais você pode encontrar informações e visualizar detalhes de suas fórmulas de contêiner do EC2 Image Builder.
**Topics**
+ [Liste as fórmulas de contêiner no console](#list-container-recipes-console)
+ [Liste receitas de contêineres com o AWS CLI](#cli-list-container-recipes)
+ [Visualizar detalhes da fórmula de contêiner no console](#view-container-recipe-details-console)
+ [Obtenha detalhes da receita do recipiente com o AWS CLI](#cli-get-container-recipe)
+ [Obtenha detalhes da política de receitas de contêineres com o AWS CLI](#cli-get-container-recipe-policy)
## Liste as fórmulas de contêiner no console
Para ver uma lista das fórmulas de contêiner que foram criadas em sua conta no console do Image Builder, siga estas etapas:
1. Abra o console do EC2 Image Builder em [ https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Escolha **Fórmulas de contêiner** do painel de navegação. Isso mostra uma lista das fórmulas de contêiner criadas em sua conta.
1. Para ver detalhes ou criar uma nova versão da fórmula, escolha o link **Nome da fórmula**. Isso abre a visualização de detalhes da fórmula.
**nota**
(Você também pode selecionar a caixa ao lado de **Nome da fórmula**, e depois escolher **Exibir detalhes**.
## Liste receitas de contêineres com o AWS CLI
O exemplo a seguir mostra como listar todas as fórmulas de contêiner, usando a AWS CLI.
```
aws imagebuilder list-container-recipes
```
O comando retorna um resumo para cada receita de contêiner, mostrado no exemplo de saída a seguir.
```
{
"requestId": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}",
"containerRecipeSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:container-recipe/{{my-container-recipe}}/1.0.0",
"name": "{{my-container-recipe}}",
"containerType": "DOCKER",
"platform": "Linux",
"owner": "{{123456789012}}",
"dateCreated": "2024-01-15T10:30:00.000Z",
"tags": {}
}
]
}
```
Você pode filtrar os resultados por proprietário para controlar quais receitas o comando retorna. Use `Self` para listar as receitas que você possui ou `Shared` para listar receitas que outras contas compartilharam com você.
```
aws imagebuilder list-container-recipes --owner Self
```
Para limitar o número de resultados que o comando retorna em cada página, use o `--max-results` parâmetro. Se houver mais resultados disponíveis, a resposta incluirá um `nextToken` valor que você passa para o próximo comando para recuperar a página seguinte.
```
aws imagebuilder list-container-recipes --max-results 10 --next-token "{{eyJuZXh0VG9rZW4...}}"
```
## Visualizar detalhes da fórmula de contêiner no console
Para visualizar detalhes de uma fórmula de contêiner específica com o console do Image Builder, selecione a fórmula de contêiner a ser visualizada e use as etapas descritas em [Liste as fórmulas de contêiner no console](#list-container-recipes-console).
Na página de detalhes da fórmula, você pode fazer o seguinte:
+ Excluir a fórmula. Para obter mais informações sobre como excluir recursos no Image Builder, consulte [Excluir recursos desatualizados ou não utilizados do Image Builder](delete-resources.md).
+ Criar uma nova versão.
+ Criar um pipeline a partir da fórmula. Depois de escolher ** Criar funil a partir desta receita**, o console abre o assistente de funil. Para obter mais informações sobre como criar um pipeline do Image Builder usando o assistente de pipeline, consulte [Tutorial: criar um pipeline de imagens com a AMI de saída por meio do assistente do console do Image Builder](start-build-image-pipeline.md)
**nota**
Quando você cria um pipeline a partir de uma fórmula existente, a opção de criar uma nova fórmula não está disponível.
## Obtenha detalhes da receita do recipiente com o AWS CLI
O exemplo a seguir mostra como usar um comando CLI **imagebuilder** para obter os detalhes de uma fórmula de contêiner especificando seu ARN.
```
aws imagebuilder get-container-recipe --container-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:container-recipe/{{my-container-recipe}}/1.0.2
```
O comando retorna a receita completa do contêiner, mostrada no exemplo de saída a seguir.
```
{
"requestId": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}",
"containerRecipe": {
"arn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:container-recipe/{{my-container-recipe}}/1.0.2",
"containerType": "DOCKER",
"name": "{{my-container-recipe}}",
"description": "{{My Linux Docker container image}}",
"platform": "Linux",
"components": [
{
"componentArn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:component/{{my-component}}/1.0.0/1"
}
],
"parentImage": "amazonlinux:latest",
"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
"targetRepository": {
"service": "ECR",
"repositoryName": "{{my-repo}}"
},
"dateCreated": "2024-01-15T10:30:00.000Z",
"owner": "{{123456789012}}"
}
}
```
## Obtenha detalhes da política de receitas de contêineres com o AWS CLI
Uma política de receitas é uma política baseada em recursos. Ele controla o acesso entre contas à sua receita. Quando você compartilha uma receita por meio de AWS Resource Access Manager (AWS RAM), o Image Builder cria a política automaticamente. Você também pode definir uma política personalizada com o `put-container-recipe-policy` comando.
O exemplo a seguir mostra como usar um comando CLI **imagebuilder** para obter os detalhes de uma política da fórmula de contêiner especificando seu ARN. Se nenhuma política for anexada à receita, a resposta estará vazia.
```
aws imagebuilder get-container-recipe-policy --container-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:container-recipe/{{my-container-recipe}}/1.0.2
```