As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Operações da API Image
<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)
```

Recupera a lista de imagens existentes.Parâmetros:

**`image_status`(obrigatório)**  
Filtra por status da imagem.  
Valores válidos: `AVAILABLE` \$1 `PENDING` \$1 `FAILED`

**`region`**  
Lista imagens construídas em uma determinada Região da AWS.

**`next_token`**  
O token para o próximo conjunto 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)
```

Crie uma AWS ParallelCluster imagem personalizada em uma determinada região.Parâmetros:

**`image_configuration`(obrigatório)**  
Configuração da imagem em dados do Python.

**`image_id`(obrigatório)**  
O ID da imagem.

**`suppress_validators`**  
Identifica um ou mais validadores de configuração de imagem a serem suprimidos.  
Formato: `(ALL | type:[A-Za-z0-9]+)`.

**`validation_failure_level`**  
O nível mínimo de validação que faz com que a criação de imagem falhe. O padrão é `ERROR`.  
Valores válidos: `INFO` \$1 `WARNING` \$1 `ERROR`

**`dry_run`**  
Se definido como`True`, AWS ParallelCluster executa a validação da solicitação sem criar nenhum recurso. Use esse parâmetro para validar a configuração da imagem. O padrão é `False`.

**`rollback_on_failure`**  
Se definido como`True`, inicia AWS ParallelCluster automaticamente uma reversão da pilha de imagens em caso de falhas. O padrão é `False`.

**`region`**  
A imagem Região da AWS.

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

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

Exclui uma imagem em uma determinada região.Parâmetros:

**`image_id`(obrigatório)**  
O ID da imagem.

**`region`**  
A imagem Região da AWS.

**`force`**  
Se definido como`True`, AWS ParallelCluster força a exclusão se as instâncias estiverem usando a AMI ou se a AMI for compartilhada. O padrão é `False`.

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

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

Obtém informações detalhadas sobre uma imagem existente.Parâmetros:

**`image_id`(obrigatório)**  
O ID da imagem.

**`region`**  
A imagem Região da AWS.