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 da imagem
Esta seção descreve as várias maneiras pelas quais você pode encontrar informações e visualizar detalhes de suas fórmulas de imagem do EC2 Image Builder.
**Topics**
+ [Listar fórmulas de imagem com o console](#list-image-recipes-console)
+ [Listar receitas de imagens do AWS CLI](#cli-list-image-recipes)
+ [Visualizar detalhes da fórmula de imagem com o console](#view-image-recipe-details-console)
+ [Obtenha detalhes da receita de imagem do AWS CLI](#cli-get-image-recipe)
+ [Obtenha detalhes da política de receitas de imagens no AWS CLI](#cli-get-image-recipe-policy)
## Listar fórmulas de imagem com o console
Para ver uma lista das fórmulas de imagem 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 imagem** do painel de navegação. Isso mostra uma lista das fórmulas de imagem 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**, depois escolher **Visualizar detalhes**.
## Listar receitas de imagens do AWS CLI
O exemplo a seguir mostra como listar todas as fórmulas de imagem usando a AWS CLI.
```
aws imagebuilder list-image-recipes
```
O comando retorna um resumo para cada receita de imagem, mostrado no exemplo de saída a seguir.
```
{
"requestId": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}",
"imageRecipeSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:image-recipe/{{my-recipe}}/1.0.0",
"name": "{{my-recipe}}",
"platform": "Linux",
"owner": "{{123456789012}}",
"parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/{{amazon-linux-2023-x86}}/x.x.x",
"dateCreated": "2024-01-15T10:30:00.000Z",
"tags": {
"Environment": "Production"
}
}
]
}
```
Você pode filtrar os resultados por proprietário para controlar quais receitas o comando retorna.
```
aws imagebuilder list-image-recipes --owner Self
```
Use `Self` para listar as receitas que você possui ou `Shared` para listar receitas que outras contas compartilharam com você.
```
aws imagebuilder list-image-recipes --owner Shared
```
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-image-recipes --max-results 10 --next-token "{{eyJuZXh0VG9rZW4...}}"
```
## Visualizar detalhes da fórmula de imagem com o console
Para ver detalhes de uma fórmula de imagem específica usando o console do Image Builder, selecione a fórmula de imagem a ser revisada e use as etapas descritas em [Listar fórmulas de imagem com o console](#list-image-recipes-console).
Na página de detalhes da fórmula, você pode:
+ Excluir a fórmula. Para obter mais informações sobre exclusão de 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 pipeline a partir desta fórmula**, você será direcionado para o assistente de pipeline. 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 de imagem do AWS CLI
O exemplo a seguir mostra como usar um comando CLI **imagebuilder** para obter os detalhes de uma fórmula de imagem especificando seu nome do recurso da Amazon (ARN).
```
aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:image-recipe/{{my-recipe}}/1.0.0
```
O comando retorna a receita completa da imagem, mostrada no exemplo de saída a seguir.
```
{
"requestId": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}",
"imageRecipe": {
"arn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:image-recipe/{{my-recipe}}/1.0.0",
"name": "{{my-recipe}}",
"description": "{{My Linux image recipe}}",
"platform": "Linux",
"version": "1.0.0",
"components": [
{
"componentArn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:component/{{my-component}}/1.0.0/1"
}
],
"parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/{{amazon-linux-2023-x86}}/x.x.x",
"dateCreated": "2024-01-15T10:30:00.000Z",
"tags": {},
"owner": "{{123456789012}}"
}
}
```
## Obtenha detalhes da política de receitas de imagens no 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-image-recipe-policy` comando.
**nota**
Se você definir a política de recursos diretamente com`put-image-recipe-policy`, deverá promover o recurso para um compartilhamento de AWS RAM recursos para que fique visível para os diretores com quem você o compartilha. Para obter mais informações, consulte [Opção 2: aplicar uma política de recursos e promover um compartilhamento de recursos existente](manage-shared-resources-share.md#share-opt2-promote-resource-share).
O exemplo a seguir mostra como usar um comando CLI **imagebuilder** para obter os detalhes de uma política de fórmula especificando seu ARN. Se nenhuma política for anexada à receita, a resposta estará vazia.
```
aws imagebuilder get-image-recipe-policy --image-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:image-recipe/{{my-recipe}}/1.0.0
```