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
<a name="dry-run-resources"></a>

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` oder`ResourceAlreadyExistsException`.

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