# `list_clusters`
<a name="pc-py-lib-api-cluster-list"></a>

```
list_clusters(region, next_token, cluster_status)
```

Retrieve the list of existing clusters.Parameters:

**`region`**  
Lists clusters deployed to a given AWS Region.

**`next_token`**  
The token for the next set of results.

**`cluster_status`**  
Filters by cluster status. The default is to list all clusters.  
Valid values: `CREATE_IN_PROGRESS` \$1 `CREATE_FAILED` \$1 `CREATE_COMPLETE` \$1 `DELETE_IN_PROGRESS` \$1 `DELETE_FAILED` \$1 `UPDATE_IN_PROGRESS` \$1 `UPDATE_COMPLETE` \$1 `UPDATE_FAILED`