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.

# Bilder auflisten
<a name="list-images"></a>

Ruft die Liste der vorhandenen benutzerdefinierten Bilder ab.

**Topics**
+ [Erforderliche Syntax](#list-images-request)
+ [Anforderungstext](#list-images-request-body)
+ [Antwortsyntax](#list-images-response)
+ [Antworttext](#list-images-response-body)
+ [Beispiel](#list-images-example)

## Erforderliche Syntax
<a name="list-images-request"></a>

```
GET /images/custom
{
  "imageStatus": "string",
  "nextToken": "string",
  "region": "string"
}
```

## Anforderungstext
<a name="list-images-request-body"></a>

**ImageStatus**  
Filtert Bilder nach dem angegebenen Status.  
Type: Zeichenkette  
Zulässige Werte: `AVAILABLE | PENDING | FAILED`  
Erforderlich: Ja

**nextToken**  
Das Token für den nächsten Ergebnissatz.  
Type: Zeichenkette  
Erforderlich: Nein

**Region**  
Die Bilder AWS-Region , in denen sich diese Bilder befinden.  
Type: Zeichenkette  
Erforderlich: Nein

## Antwortsyntax
<a name="list-images-response"></a>

```
{
  "nextToken": "string",
  "images": [
    {
      "imageId": "string",
      "ec2AmiInfo": {
        "amiId": "string"
      },
      "region": "string",
      "version": "string",
      "cloudformationStackArn": "string",
      "imageBuildStatus": "BUILD_IN_PROGRESS",
      "cloudformationStackStatus": "CREATE_IN_PROGRESS"
    }
  ]
}
```

## Antworttext
<a name="list-images-response-body"></a>

**Bilder**  
Eine Liste von Bildern.    
**cloudformationStackArn**  
Der Amazon-Ressourcenname (ARN) des CloudFormation Hauptstapels.  
Type: Zeichenkette  
**cloudformationStackStatus**  
Der CloudFormation Stack-Status.  
Type: Zeichenkette  
Zulässige Werte: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE`  
**ec2 AmiInfo**    
**ami\_id**  
Die Amazon EC2 AMI-ID.  
Type: Zeichenkette  
**imageBuildStatus**  
Der Status der Image-Erstellung.  
Zulässige Werte: `BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE`  
Type: Zeichenkette  
**imageId**  
Die ID des Images.  
Type: Zeichenkette  
**Region**  
Die, AWS-Region in der das Bild erstellt wurde.  
Type: Zeichenkette  
**version**  
Die AWS ParallelCluster Version, mit der das Image erstellt wurde.  
Type: Zeichenkette

**nextToken**  
Ein Token, mit dem der nächste Ergebnissatzes abgerufen werden kann, bzw. `null`, wenn keine weiteren Ergebnisse vorliegen.  
Type: Zeichenkette

## Beispiel
<a name="list-images-example"></a>

------
#### [ Python ]

**Anforderung**

```
$ list_images({{"AVAILABLE"}})
```

**200 Antwort**

```
{
  'images': [
    {
      'ec2_ami_info': {
        'ami_id': 'ami-abcdef01234567890'
      },
      'image_build_status': 'BUILD_COMPLETE',
      'image_id': 'custom-image',
      'region': 'us-east-1',
      'version': '3.2.1'
    }
  ]
}
```

------