View a markdown version of this page

Valide a criação de recursos do Image Builder com um teste - EC2 Image Builder

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

Valide a criação de recursos do Image Builder com um teste

Com uma execução seca, você pode verificar se uma solicitação para criar um recurso do Image Builder seria bem-sucedida, sem criar o recurso. Quando você define o dryRun parâmetro como true em sua solicitação, o Image Builder valida as permissões e os parâmetros de solicitação necessários e, em seguida, para antes de criar qualquer coisa. O resultado é um dos seguintes:

  • Se a validação for bem-sucedida, a solicitação falhará com um DryRunOperationException erro. Esse erro indica que a solicitação é válida e que a criação do recurso teria sido bem-sucedida sem o dryRun parâmetro.

  • Se a validação falhar, a solicitação retornará o mesmo erro que retornaria sem o dryRun parâmetro, por exemplo InvalidParameterValueException ouResourceAlreadyExistsException.

Em ambos os casos, o Image Builder não cria o recurso. As tiragens a seco fornecem feedback imediato sobre suas configurações de recursos. Isso é especialmente útil para agentes de automação e IA que criam recursos do Image Builder. Essas ferramentas podem validar cada configuração e corrigir erros antes de criar qualquer coisa.

As ações de criação a seguir oferecem suporte ao dryRun parâmetro:

  • CreateComponent

  • CreateContainerRecipe

  • CreateDistributionConfiguration

  • CreateImagePipeline

  • CreateImageRecipe

  • CreateInfrastructureConfiguration

  • CreateLifecyclePolicy

  • CreateWorkflow

nota

A CreateImage ação não suporta o dryRun parâmetro, porque inicia a criação de uma imagem em vez de criar um recurso de configuração.

Execute uma operação a seco a partir do AWS CLI

O exemplo a seguir mostra como validar uma configuração de infraestrutura com o create-infrastructure-configuration comando. A --dry-run opção transforma a solicitação em uma execução seca.

aws imagebuilder create-infrastructure-configuration \
    --name my-example-infrastructure-configuration \
    --instance-profile-name EC2InstanceProfileForImageBuilder \
    --dry-run

Se a configuração for válida, o comando retornará o seguinte erro para mostrar que a solicitação teria sido bem-sucedida.

An error occurred (DryRunOperationException) when calling the CreateInfrastructureConfiguration operation: Request would have succeeded, but dryRun flag is set.