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.

# Image-API-Operationen
<a name="pc-py-lib-api-image"></a>

**Topics**
+ [`list_images`](pc-py-lib-api-image-list.md)
+ [`build_image`](pc-py-lib-api-image-build.md)
+ [`delete_image`](pc-py-lib-api-image-delete.md)
+ [`describe_image`](pc-py-lib-api-image-describe.md)

# `list_images`
<a name="pc-py-lib-api-image-list"></a>

```
list_images(image_status, region, next_token)
```

Ruft die Liste der vorhandenen Bilder ab.Parameter:

**`image_status` (Erforderlich)**  
Filtert nach Bildstatus.  
Zulässige Werte: `AVAILABLE` \$1 `PENDING` \$1 `FAILED`

**`region`**  
Listet Bilder auf, die in einem bestimmten Objekt erstellt wurden AWS-Region.

**`next_token`**  
Das Token für den nächsten Ergebnissatz.

# `build_image`
<a name="pc-py-lib-api-image-build"></a>

```
build_image(image_configuration, image_id, suppress_validators, validation_failure_level, dry_run, rollback_on_failure, region)
```

Erstellen Sie ein benutzerdefiniertes AWS ParallelCluster Bild in einer bestimmten Region.Parameter:

**`image_configuration` (Erforderlich)**  
Die Bildkonfiguration als Python-Daten.

**`image_id` (Erforderlich)**  
Die Bild-ID.

**`suppress_validators`**  
Identifiziert einen oder mehrere Validatoren für die Image-Konfiguration, die unterdrückt werden sollen.  
Format: `(ALL | type:[A-Za-z0-9]+)`

**`validation_failure_level`**  
Die Mindestvalidierungsstufe, die dazu führt, dass die Image-Erstellung fehlschlägt. Der Standardwert ist `ERROR`.  
Zulässige Werte: `INFO` \$1 `WARNING` \$1 `ERROR`

**`dry_run`**  
Wenn auf gesetzt`True`, wird die AWS ParallelCluster Anforderungsvalidierung durchgeführt, ohne Ressourcen zu erstellen. Sie können dies verwenden, um die Image-Konfiguration zu überprüfen. Der Standardwert ist `False`.

**`rollback_on_failure`**  
Wenn diese Option auf gesetzt ist`True`, AWS ParallelCluster wird bei Fehlern automatisch ein Rollback des Image-Stacks initiiert. Der Standardwert ist `False`.

**`region`**  
Das AWS-Region-Abbild.

# `delete_image`
<a name="pc-py-lib-api-image-delete"></a>

```
delete_image(image_id, region, force)
```

Löscht ein Bild in einer bestimmten Region.Parameter:

**`image_id` (Erforderlich)**  
Die Bild-ID.

**`region`**  
Das AWS-Region-Abbild.

**`force`**  
Wenn auf gesetzt`True`, wird das Löschen AWS ParallelCluster erzwungen, wenn Instances das AMI verwenden oder wenn das AMI gemeinsam genutzt wird. Der Standardwert ist `False`.

# `describe_image`
<a name="pc-py-lib-api-image-describe"></a>

```
describe_image(image_id, region)
```

Ruft detaillierte Informationen zu einem vorhandenen Bild ab.Parameter:

**`image_id` (Erforderlich)**  
Die Bild-ID.

**`region`**  
Das AWS-Region-Abbild.