View a markdown version of this page

Liste e visualize detalhes da fórmula da imagem - EC2 Image Builder
Listar fórmulas de imagem com o consoleListar receitas de imagens do AWS CLIVisualizar detalhes da fórmula de imagem com o consoleObtenha detalhes da receita de imagem do AWS CLIObtenha detalhes da política de receitas de imagens no AWS CLI

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.

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

  2. Escolha Fórmulas de imagem do painel de navegação. Isso mostra uma lista das fórmulas de imagem criadas em sua conta.

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

Na página de detalhes da fórmula, você pode:

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

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