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.

# Bild löschen
<a name="delete-image"></a>

Initiieren Sie das Löschen des benutzerdefinierten Images. AWS ParallelCluster 

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

## Erforderliche Syntax
<a name="delete-image-request"></a>

```
DELETE /v3/images/custom/{{{imageId}}}
{
  "force": boolean,
  "region": "string"
}
```

## Anforderungstext
<a name="delete-image-request-body"></a>

**imageId**  
Die ID des Bildes.  
Type: Zeichenkette  
Erforderlich: Ja

**force**  
Wenn auf gesetzt`true`, erzwingt das Löschen des AMI. Verwenden Sie diesen Parameter, wenn es Instances gibt, die das AMI verwenden, oder wenn das AMI gemeinsam genutzt wird. Der Standardwert ist `false`.  
Typ: Boolesch  
Erforderlich: Nein

**Region**  
Das, AWS-Region in dem das Image erstellt wurde.  
Type: Zeichenkette  
Erforderlich: Nein

## Antwortsyntax
<a name="delete-image-response"></a>

```
{
  "image": {
    "imageId": "string",
    "ec2AmiInfo": {
      "amiId": "string"
    },
    "region": "string",
    "version": "string",
    "cloudformationStackArn": "string",
    "imageBuildStatus": "DELETE_IN_PROGRESS",
    "cloudformationStackStatus": "DELETE_IN_PROGRESS"
  }
}
```

## Antworttext
<a name="delete-image-response-body"></a>

**Abbild**    
**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**    
**Ich bin ID**  
Die Amazon EC2 AMI-ID.  
Type: Zeichenkette  
**imageBuildStatus**  
Der Status der Image-Erstellung.  
Type: Zeichenkette  
Zulässige Werte: `BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE`  
**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

## Beispiel
<a name="delete-image-example"></a>

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

**Anforderung**

```
$ delete_image({{custom-image-id}})
```

**200 Antwort**

```
{
  "image": {
    "image_build_status": "DELETE_IN_PROGRESS",
    "image_id": "custom-image-id",
    "region": "us-east-1",
    "version": "3.2.1"
  }
}
```

------