View a markdown version of this page

Überprüfen Sie die Image Builder Builder-Ressourcenerstellung mit einem Probelauf - EC2 Image Builder

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Überprüfen Sie die Image Builder Builder-Ressourcenerstellung mit einem Probelauf

Mit einem Probelauf können Sie überprüfen, ob eine Anfrage zum Erstellen einer Image Builder Builder-Ressource erfolgreich sein würde, ohne die Ressource zu erstellen. Wenn Sie den dryRun Parameter true in Ihrer Anfrage auf setzen, überprüft Image Builder die erforderlichen Berechtigungen und Anforderungsparameter und stoppt dann, bevor etwas erstellt wird. Das Ergebnis ist eines der folgenden:

  • Wenn die Überprüfung erfolgreich ist, schlägt die Anfrage mit einem DryRunOperationException Fehler fehl. Dieser Fehler weist darauf hin, dass die Anforderung gültig ist und dass die Ressourcenerstellung ohne den dryRun Parameter erfolgreich gewesen wäre.

  • Schlägt die Überprüfung fehl, gibt die Anforderung denselben Fehler zurück, den sie auch ohne den dryRun Parameter zurückgeben würde, z. B. InvalidParameterValueException oderResourceAlreadyExistsException.

In beiden Fällen erstellt Image Builder die Ressource nicht. Probeläufe geben Ihnen sofortiges Feedback zu Ihren Ressourcenkonfigurationen. Dies ist besonders nützlich für Automatisierungs- und KI-Agenten, die Image Builder Builder-Ressourcen erstellen. Solche Tools können jede Konfiguration überprüfen und Fehler korrigieren, bevor sie etwas erstellen.

Die folgenden Erstellungsaktionen unterstützen den dryRun Parameter:

  • CreateComponent

  • CreateContainerRecipe

  • CreateDistributionConfiguration

  • CreateImagePipeline

  • CreateImageRecipe

  • CreateInfrastructureConfiguration

  • CreateLifecyclePolicy

  • CreateWorkflow

Anmerkung

Die CreateImage Aktion unterstützt den dryRun Parameter nicht, da sie einen Image-Build startet, anstatt eine Konfigurationsressource zu erstellen.

Führen Sie einen Probelauf von AWS CLI

Das folgende Beispiel zeigt, wie eine Infrastrukturkonfiguration mit dem create-infrastructure-configuration Befehl validiert wird. Die --dry-run Option verwandelt die Anfrage in einen Probelauf.

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

Wenn die Konfiguration gültig ist, gibt der Befehl den folgenden Fehler zurück, um anzuzeigen, dass die Anfrage erfolgreich gewesen wäre.

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