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.

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 ver a API ação, consulte ListImagesna APIReferência do EC2 Image Builder. Para a SDK solicitação associada, consulte o link Consulte também na mesma página.

Listar imagens no console

Siga estas etapas para abrir a página da lista de imagens no console:

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.

Listar imagens com AWS CLI comandos

Ao executar o list-images 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 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 o API ou an SDK para obter uma lista das etapas do fluxo de trabalho que estão aguardando ação. Para ver a API ação, consulte ListWaitingWorkflowStepsna APIReferência do EC2 Image Builder. Para a SDK solicitação associada, consulte o link Consulte também 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/.

2. Escolha Imagens no painel de navegação. Isso abrirá a página da lista Imagens.

3. Selecione a guia Aguardando ação na página da lista.

4. (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.

• Fluxo de trabalho ARN — O nome do recurso 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 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 o Image Builder API ou AWS CLI para listar 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 ver a API ação, consulte ListImageBuildVersionsna APIReferência do EC2 Image Builder. Para a SDK solicitação associada, consulte o link Consulte também 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 imagem 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 Amazon Resource Name (ARN) para a versão referenciada do recurso de imagem.

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

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

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