Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Operaciones de la API de imagen
<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)
```

Obtenga la lista de imágenes existentes.Parámetros:

**`image_status` (obligatorio)**  
Filtra por estado de imagen.  
Valores válidos: `AVAILABLE` \$1 `PENDING` \$1 `FAILED`

**`region`**  
Muestra las imágenes creadas en una Región de AWS determinada.

**`next_token`**  
El token del conjunto siguiente de resultados.

# `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)
```

Crea una AWS ParallelCluster imagen personalizada en una región determinada.Parámetros:

**`image_configuration` (obligatorio)**  
La configuración de la imagen como datos de Python.

**`image_id` (obligatorio)**  
El ID de imagen.

**`suppress_validators`**  
Identifica uno o más validadores de configuración de imágenes para suprimirlos.  
Formato: `(ALL | type:[A-Za-z0-9]+)`

**`validation_failure_level`**  
El nivel mínimo de validación que provoca un error en la creación de la imagen. El valor predeterminado es `ERROR`.  
Valores válidos: `INFO` \$1 `WARNING` \$1 `ERROR`

**`dry_run`**  
Si se establece en`True`, AWS ParallelCluster realiza la validación de la solicitud sin crear ningún recurso. Puede usarlo para validar la configuración de la imagen. El valor predeterminado es `False`.

**`rollback_on_failure`**  
Si se establece en`True`, inicia AWS ParallelCluster automáticamente una reversión de la pila de imágenes en caso de errores. El valor predeterminado es `False`.

**`region`**  
La imagen Región de AWS.

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

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

Elimine una imagen de una región determinada.Parámetros:

**`image_id` (obligatorio)**  
El ID de imagen.

**`region`**  
La imagen Región de AWS.

**`force`**  
Si se establece en`True`, AWS ParallelCluster fuerza la eliminación si las instancias utilizan la AMI o si la AMI es compartida. El valor predeterminado es `False`.

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

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

Obtenga información detallada sobre una imagen existente.Parámetros:

**`image_id` (obligatorio)**  
El ID de imagen.

**`region`**  
La imagen Región de AWS.