Validez la création de ressources Image Builder par un essai à sec

Avec un essai à sec, vous pouvez vérifier si une demande de création d'une ressource Image Builder aboutira, sans créer la ressource. Lorsque vous définissez le dryRun paramètre sur true dans votre demande, Image Builder valide les autorisations et les paramètres de demande requis, puis s'arrête avant de créer quoi que ce soit. Le résultat est l'un des suivants :

• Si la validation aboutit, la demande échoue avec une DryRunOperationException erreur. Cette erreur indique que la demande est valide et que la création de la ressource aurait réussi sans le dryRun paramètre.

• Si la validation échoue, la demande renvoie la même erreur qu'elle renverrait sans le dryRun paramètre, par exemple InvalidParameterValueException ouResourceAlreadyExistsException.

Dans les deux cas, Image Builder ne crée pas la ressource. Les essais à sec vous donnent un feedback immédiat sur la configuration de vos ressources. Cela est particulièrement utile pour les agents d'automatisation et d'intelligence artificielle qui créent des ressources Image Builder. Ces outils peuvent valider chaque configuration et corriger les erreurs avant de créer quoi que ce soit.

Les actions de création suivantes prennent en charge le dryRun paramètre :

• CreateComponent

• CreateContainerRecipe

• CreateDistributionConfiguration

• CreateImagePipeline

• CreateImageRecipe

• CreateInfrastructureConfiguration

• CreateLifecyclePolicy

• CreateWorkflow

Note

L'CreateImageaction ne prend pas en charge le dryRun paramètre, car elle lance la création d'une image au lieu de créer une ressource de configuration.

Effectuez un essai à sec à partir du AWS CLI

L'exemple suivant montre comment valider une configuration d'infrastructure à l'aide de la create-infrastructure-configuration commande. L'--dry-runoption transforme la demande en un essai à sec.

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

Si la configuration est valide, la commande renvoie l'erreur suivante pour indiquer que la demande aurait abouti.

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