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á. # Listar versões de compilação e imagens Na página **Imagens** no console do Image Builder, você pode ver listas de todos os recursos de imagem do Image Builder que você possui, que estão compartilhados com você e aos quais você tem acesso. Os resultados da lista incluem alguns detalhes importantes sobre esses recursos. Você também pode ver todas as imagens em sua conta que têm ações pendentes de fluxo de trabalho. **Topics** + [Listar imagens](#list-images) + [Listar imagens que estão aguardando ação](#list-images-waiting-for-action) + [Listar versões da compilação de imagem](#list-image-build-versions) ## Listar imagens Esta seção descreve as diferentes maneiras pelas quais você pode listar informações sobre suas imagens. Você pode usar um dos métodos a seguir para listar os recursos de imagem do Image Builder aos quais você tem acesso. Para a ação da API, consulte [ListImages](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html)na *Referência da API do EC2 Image Builder*. Para ver a solicitação de SDK associada, consulte o link [Consulte também](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html#API_ListImages_SeeAlso) na mesma página. **Topics** + [Listar imagens no console](#list-images-console) + [Listar imagens com AWS CLI comandos](#list-images-cli) ### Listar imagens no console Siga estas etapas para abrir a página da lista de **imagens** no console: 1. Abra o console do EC2 Image Builder em [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Escolha **Imagens** no painel de navegação. A página **Imagens** no console é dividida em guias, com base no proprietário da imagem ou nas ações pendentes de fluxo de trabalho. Esta seção aborda as três primeiras guias que mostram as imagens de sua propriedade ou às quais você tem acesso. #### Guia do console: De minha propriedade Na guia **De minha propriedade**, você pode usar os filtros a seguir para otimizar os resultados da lista de imagens. + É possível pesquisar pelo nome inteiro ou por parte do nome na barra de pesquisas. + É possível filtrar imagens com base na plataforma do sistema operacional (Windows, Linux ou macOS). + É possível filtrar imagens com base no tipo de saída que elas produzem (AMI ou imagem de contêiner). + Você pode usar a **fonte de filtro** para encontrar imagens que foram importadas de uma máquina virtual (VMIE) ou de uma imagem de disco ISO. Além dos controles de filtro, a guia **De minha propriedade** mostra uma lista das imagens do Image Builder que você criou, com os seguintes detalhes dos recursos listados: **Nome/versão** Os nomes dos recursos de imagem do Image Builder começam com o nome e a versão da fórmula que serviu de base para a compilação deles. Selecione o link para ver todas as versões relacionadas de compilação de imagens. **Tipo** O tipo de imagem de saída que o Image Builder cria para esse recurso de imagem (uma AMI ou uma imagem de contêiner). **Plataforma** A plataforma do sistema operacional do recurso de imagem; por exemplo, “Linux”, “Windows” ou “macOS”. **Fonte da imagem** A origem da imagem de base que o Image Builder usou para compilar esse recurso de imagem. Isso é usado principalmente para filtrar resultados de imagens que foram importadas de uma máquina virtual (**VMIE**). **Hora de criação** A data e a hora em que o Image Builder criou a versão atual do recurso de imagem. **ARN** O nome do recurso da Amazon (ARN) da versão atual do recurso de imagem. #### Guia do console: Compartilhado comigo Na guia **Compartilhado comigo**, você pode usar os filtros a seguir para otimizar os resultados da lista de imagens. + É possível pesquisar pelo nome inteiro ou por parte do nome na barra de pesquisas. + É possível filtrar imagens com base na plataforma do sistema operacional (Windows, Linux ou macOS). + É possível filtrar imagens com base no tipo de saída que elas produzem (AMI ou imagem de contêiner). + Você pode usar a **fonte de filtro** para encontrar imagens que foram importadas de uma máquina virtual (VMIE) ou de uma imagem de disco ISO. Além dos controles de filtro, a guia **Compartilhado comigo** mostra uma lista das imagens do Image Builder que foram compartilhadas com você, com os seguintes detalhes dos recursos listados: **Nome da imagem** O nome do recurso de imagem que foi compartilhado com você. Para usar uma imagem compartilhada em uma fórmula, selecione a opção **Selecionar imagens gerenciadas** e altere a **Origem da imagem** para **Imagens compartilhadas comigo**. **Tipo** O tipo de imagem de saída que o Image Builder cria para esse recurso de imagem (uma AMI ou uma imagem de contêiner). **Versão** A versão da plataforma do sistema operacional para o recurso de imagem, geralmente um campo numérico no seguinte formato: ... **Fonte da imagem** A origem da imagem de base que o Image Builder usou para compilar esse recurso de imagem, se for o caso. Isso é usado principalmente para filtrar resultados de imagens que foram importadas de uma máquina virtual (**VMIE**). **Plataforma** A plataforma do sistema operacional do recurso de imagem; por exemplo, “Linux”, “Windows” ou “macOS”. **Hora de criação** A data e a hora em que o Image Builder criou a versão do recurso de imagem que foi compartilhada com você. **Proprietário** O proprietário do recurso de imagem compartilhada. **ARN** O nome do recurso da Amazon (ARN) da versão do recurso de imagem que foi compartilhada com você. #### Guia do console: Gerenciado pela Amazon Na guia **Gerenciado pela Amazon**, você pode usar os filtros a seguir para otimizar os resultados da lista de imagens. + É possível pesquisar pelo nome inteiro ou por parte do nome na barra de pesquisas. + É possível filtrar imagens com base na plataforma do sistema operacional (Windows, Linux ou macOS). + É possível filtrar imagens com base no tipo de saída que elas produzem (AMI ou imagem de contêiner). + Você pode usar a **fonte de filtro** para encontrar imagens que foram importadas de uma máquina virtual (VMIE) ou de uma imagem de disco ISO. Seguindo os controles de filtro, a guia **Gerenciado pela Amazon** mostra uma lista de imagens do Image Builder gerenciadas pela Amazon que você pode usar como imagens de base para suas fórmulas. O Image Builder exibe os seguintes detalhes dos recursos listados: **Nome da imagem** O nome da imagem gerenciada. Quando você cria uma fórmula, o padrão para sua imagem de base é **Início rápido (gerenciado pela Amazon)**. As imagens listadas nessa guia preenchem a lista **Nomes de imagem** associada à plataforma do sistema operacional que você escolhe para sua imagem de base ao criar uma fórmula. **Tipo** O tipo de imagem de saída que o Image Builder cria para esse recurso de imagem (uma AMI ou uma imagem de contêiner). **Versão** A versão da plataforma do sistema operacional para o recurso de imagem, geralmente um campo numérico no seguinte formato: ... **Plataforma** A plataforma do sistema operacional do recurso de imagem; por exemplo, “Linux”, “Windows” ou “macOS”. **Hora de criação** A data e a hora em que o Image Builder criou a versão do recurso de imagem que foi compartilhada com você. **Proprietário** A Amazon é proprietária das imagens gerenciadas. **ARN** O nome do recurso da Amazon (ARN) da versão do recurso de imagem que foi compartilhada com você. ### Listar imagens com AWS CLI comandos Ao executar o **[list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)** comando no AWS CLI, você pode obter uma lista de imagens que você possui ou às quais tem acesso. O exemplo de comando a seguir mostra como usar o comando **list-images** sem filtros para listar todos os recursos de imagem do Image Builder de sua propriedade. **Exemplo: listar todas as imagens** ``` aws imagebuilder list-images ``` **Saída:** ``` { "requestId": "1abcd234-e567-8fa9-0123-4567b890cd12", "imageVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0", "platform": "Linux", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-win/1.0.1", "name": "image-recipe-win", "type": "AMI", "version": "1.0.1", "platform": "Windows", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-macos/1.1.1", "name": "image-recipe-macos", "type": "AMI", "version": "1.1.1", "platform": "macOS", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" } ] } ``` Ao executar o comando **list-images**, você pode aplicar filtros para otimizar os resultados, como mostra o exemplo a seguir. Para obter mais informações sobre como filtrar seus resultados, consulte o comando [list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) na *AWS CLI Referência de comandos*. **Exemplo: filtrar para imagens do Linux** ``` aws imagebuilder list-images --filters name="{{platform}}",values="{{Linux}}" ``` **Saída:** ``` { "requestId": "1abcd234-e567-8fa9-0123-4567b890cd12", "imageVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0", "platform": "Linux", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" } ] } ``` ## Listar imagens que estão aguardando ação Quando você usa a ação de etapa `WaitForAction` em seu fluxo de trabalho de imagem, ela pausa o fluxo de trabalho até que você envie um sinal para retomar o processamento ou falhar no fluxo de trabalho. É possível usar essa ação de etapa se houver um processo externo que precise ser executado antes de você continuar. Em seguida, você poderá usar o `SendWorkflowStepAction` para enviar um sinal para a etapa pausada para `RESUME` ou `STOP`. Também é possível interromper ou retomar seu fluxo de trabalho diretamente do console. As guias a seguir mostram como obter uma lista de todos os recursos de imagem em sua conta com etapas do fluxo de trabalho que estejam pausadas aguardando um sinal para retomar ou parar. As guias abrangem as etapas do console e o AWS CLI comando. Você também pode usar a API ou um SDK para obter uma lista das etapas do fluxo de trabalho que estão aguardando ação. Para a ação da API, consulte [ListWaitingWorkflowSteps](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html)na *Referência da API do EC2 Image Builder*. Para ver a solicitação de SDK associada, consulte o link [Consulte também](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html#API_ListWaitingWorkflowSteps_SeeAlso) na mesma página. ------ #### [ Console ] Para acessar a guia **Aguardando ação** no console, 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 **Imagens** no painel de navegação. Isso abrirá a página da lista **Imagens**. 1. Selecione a guia **Aguardando ação** na página da lista. 1. (opcional) Para interromper ou retomar uma etapa, marque a caixa de seleção ao lado do nome e escolha **Parar etapa** ou **Retomar etapa**. Você pode marcar mais de uma caixa de seleção para realizar a mesma ação em todas as etapas selecionadas. **Detalhes da etapa pendente do fluxo de trabalho** Os detalhes do fluxo de trabalho da etapa pendente incluem o seguinte: + **Nome da imagem**: o nome do recurso de imagem que está com a etapa pendente. Você pode selecionar o link do nome para exibir a página de detalhes dessa imagem. + **Nome da etapa pendente**: o nome da etapa do fluxo de trabalho que está aguardando ação. + **ID de execução da etapa**: identifica de maneira exclusiva a instância de runtime da etapa do fluxo de trabalho. Você pode selecionar a ID vinculada para exibir os detalhes do runtime da etapa. + **Início da etapa**: o carimbo de data e hora em que a instância de runtime da etapa de fluxo de trabalho foi iniciada. + **ARN de fluxo de trabalho**: o nome do recurso da Amazon (ARN) do fluxo de trabalho com a etapa pendente. + **Ações**: a ação escalonada que está em estado de espera. ------ #### [ AWS CLI ] Ao executar o **[list-waiting-workflow-steps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-waiting-workflow-steps.html)** comando no AWS CLI, você receberá uma lista de todas as imagens em sua conta que têm etapas de fluxo de trabalho que aguardam ação antes de concluir o processo de criação da imagem. O exemplo de comando a seguir mostra como usar o comando **list-waiting-workflow-steps** para listar todas as imagens em sua conta com etapas do fluxo de trabalho que estão aguardando ação. **Exemplo: listar imagens em sua conta com etapas de fluxo de trabalho aguardando** ``` aws imagebuilder list-waiting-workflow-steps ``` **Saída**: A saída deste exemplo mostra uma imagem na conta com uma etapa aguardando ação. ``` { "steps": [ { "imageBuildVersionArn": "arn:aws:imagebuilder:{{us-west-2}}:{{111122223333}}:image/{{example-image}}/{{1.0.0}}/8", "name": "{{WaitForAction}}", "workflowExecutionId": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "stepExecutionId": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "workflowBuildVersionArn": "arn:aws:imagebuilder:{{us-west-2}}:{{111122223333}}:workflow/test/{{wait-for-action}}/{{1.0.0}}/1", "startTime": "2023-11-21T23:21:23.609Z", "action": "WaitForAction" } ] } ``` ------ ## Listar versões da compilação de imagem Na página **Versões da compilação de imagem** do console do Image Builder, você pode ver uma lista de versões da compilação e detalhes adicionais de um recurso de imagem que você possui. Você também pode usar comandos ou ações com a API Image Builder ou listar AWS CLI as versões de criação de imagens. SDKs Você pode usar um dos métodos a seguir para listar as versões de compilação de imagem dos recursos de imagem que você possui. Para a ação da API, consulte [ListImageBuildVersions](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html)na *Referência da API do EC2 Image Builder*. Para ver a solicitação de SDK associada, consulte o link [Consulte também](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html#API_ListImageBuildVersions_SeeAlso) na mesma página. ------ #### [ Console ] **Detalhes da versão** Os detalhes na página de **Versões do Image Builder** no console do Image Builder incluem o seguinte: + **Versão** – A versão da compilação do recurso de imagem. No console do Image Builder, a versão é vinculada a uma página de detalhes da imagem. + **Tipo** – O tipo de saída que o Image Builder distribuiu ao criar esse recurso de imagem (uma AMI ou uma imagem de contêiner). + **Data de criação** – A data e a hora em que o Image Builder criou a versão de compilação da imagem. + **Status da imagem** – O status atual da versão de compilação da imagem. O status pode estar relacionado à compilação ou disposição da imagem. Por exemplo, durante o processo de compilação, você pode ver um status de `Building` ou `Distributing`. Para a disposição da imagem, você pode ver um status de `Deprecated` ou `Deleted`. + **Motivo da falha** – O motivo do status da imagem. O console do Image Builder somente exibe o motivo quando a compilação falha (o **Status da imagem** é igual a `Failed`). + **Descobertas de segurança** – As descobertas agregadas da varredura de imagens para a versão de compilação da imagem referenciada. + **ARN** – O nome do recurso da Amazon (ARN) para a versão do recurso de imagem referenciada. + **Fluxo de logs** – Um link para os detalhes do fluxo de logs para a versão de compilação da imagem referenciada. **Listar versões** Para listar as versões de compilação de imagem no console do Image Builder, realize as seguintes etapas: 1. Abra o console do EC2 Image Builder em [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Escolha **Imagens** no painel de navegação. Por padrão, a lista de imagens mostra a versão atual de cada uma das imagens que você possui. 1. Para ver uma lista de todas as versões de uma imagem, escolha o link da versão atual. O link abre a página **Versões de compilação da imagem** que lista todas as versões de compilação de uma imagem específica. ------ #### [ AWS CLI ] Ao executar o **[list-image-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)** comando no AWS CLI, você receberá uma lista completa das versões de compilação do recurso de imagem especificado. Você precisa ser o proprietário da imagem para executar esse comando. O exemplo de comando a seguir mostra como usar o comando **list-image-build-versions** para listar todas as versões da compilação da imagem especificada. **Exemplo: listar versões da compilação para uma imagem específica** ``` aws imagebuilder list-image-build-versions --image-version-arn arn:aws:imagebuilder:{{us-west-2}}:{{123456789012}}:image/{{image-recipe-name}}/{{1.0.0}} ``` **Saída:** A saída para esse exemplo inclui duas versões de compilação para a fórmula de imagem especificada. ``` { "requestId": "12f3e45d-67cb-8901-af23-45ed678c9b01", "imageSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/2", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0/2", "platform": "Linux", "osVersion": "Amazon Linux 2", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2023-03-10T01:04:40.609Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-012b3456789012c3d", "name": "image-recipe-name 2023-03-10T01-05-12.541Z", "description": "First verison of image-recipe-name", "accountId": "123456789012" } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/1", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0/1", "platform": "Linux", "osVersion": "Amazon Linux 2", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2023-03-10T00:07:16.384Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-0d1e23456789f0a12", "name": "image-recipe-name 2023-03-10T00-07-18.146132Z", "description": "First verison of image-recipe-name", "accountId": "123456789012" } ] }, "tags": {} } ] } ``` **nota** No momento, a saída do comando **list-image-build-versions** não inclui descobertas de segurança ou fluxos de logs. ------