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á.

# Monitoramento do status de um cluster do Amazon DocumentDB
<a name="monitoring_docdb-cluster_status"></a>

O status de um cluster indica a integridade do cluster. Você pode visualizar o status de um cluster usando o console do Amazon DocumentDB ou o AWS CLI `describe-db-clusters` comando.

**Topics**
+ [Valores de status do cluster](#monitoring_docdb-status_values)
+ [Monitorar o status de um cluster](#monitor-cluster-status)

## Valores de status do cluster
<a name="monitoring_docdb-status_values"></a>

A tabela a seguir lista os valores válidos para o status de um cluster.


| Status do cluster | Description | 
| --- | --- | 
| active | O cluster está ativo. Esse status se aplica somente a clusters elásticos. | 
| available | O cluster está íntegro e disponível. Esse status se aplica somente a clusters baseados em instâncias. | 
| backing-up | O backup do cluster está sendo executado no momento. | 
| creating | O cluster está sendo criado. Ele fica inacessível enquanto está sendo criado. | 
| deleting | O cluster está sendo excluído. Ele fica inacessível enquanto está sendo excluído. | 
| failing-over | Um failover da instância principal para uma réplica do Amazon DocumentDB está sendo executado. | 
| inaccessible-encryption-credentials | A AWS KMS chave usada para criptografar ou descriptografar o cluster não pode ser acessada. | 
| maintenance | Uma atualização de manutenção está sendo aplicada ao cluster. Esse status é usado para a manutenção em nível de cluster que o Amazon DocumentDB programa com antecedência. | 
| migrating | Um snapshot do cluster está sendo restaurado em um cluster. | 
| migration-failed | Ocorreu uma falha na migração. | 
| modifying | O cluster está sendo modificado devido a uma solicitação do cliente para modificá-lo. | 
| renaming | O cluster está sendo renomeado devido a uma solicitação do cliente para renomeá-lo. | 
| resetting-master-credentials | As credenciais principais do cluster estão sendo redefinidas devido a uma solicitação do cliente para redefini-las. | 
| upgrading | A versão do mecanismo do cluster está sendo atualizada. | 

## Monitorar o status de um cluster
<a name="monitor-cluster-status"></a>

------
#### [ Using the Console de gerenciamento da AWS ]

Ao usar o Console de gerenciamento da AWS para determinar o status de um cluster, use o procedimento a seguir.

1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)

1. No painel de navegação, escolha **Clusters**.

1. Na caixa de navegação Clusters, você verá a coluna **Identificador do cluster**. Suas instâncias estão listadas em clusters, semelhante à captura de tela abaixo.  
![\[Tabela de clusters mostrando como uma instância está aninhada sob um cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png)

1. Na coluna **Identificador de cluster**, encontre o nome da instância desejada. Em seguida, para localizar o status da instância, leia essa linha para a coluna **Status**, como mostrado a seguir.  
![\[Instância do cluster, mostrando o status disponível.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-status-con.png)

------
#### [ Using the AWS CLI ]

Ao usar o AWS CLI para determinar o status de um cluster, use a `describe-db-clusters` operação. O código a seguir descobre o status do cluster `sample-cluster`.

Para Linux, macOS ou Unix:

```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster  \
    --query 'DBClusters[*].[DBClusterIdentifier,Status]'
```

Para Windows:

```
aws docdb describe-db-clusters ^
    --db-cluster-identifier sample-cluster  ^
    --query 'DBClusters[*].[DBClusterIdentifier,Status]'
```

A saída dessa operação é semelhante à seguinte.

```
[
    [
        "sample-cluster",
        "available"
    ]
]
```

------