本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 监控 Amazon DocumentDB 集群的状态
<a name="monitoring_docdb-cluster_status"></a>

集群的状态表示集群的运行状况。您可以使用 Amazon DocumentDB 控制台或命令查看集群的 AWS CLI `describe-db-clusters`状态。

**Topics**
+ [集群状态值](#monitoring_docdb-status_values)
+ [监控集群的状态](#monitor-cluster-status)

## 集群状态值
<a name="monitoring_docdb-status_values"></a>

下表列出集群状态的有效值。


| 集群状态 | 说明 | 
| --- | --- | 
| active | 集群为活动状态。此状态仅适用于弹性集群。 | 
| available | 集群状态良好且可用。此状态仅适用于基于实例的集群。 | 
| backing-up | 当前正在备份集群。 | 
| creating | 正在创建集群。正在创建的过程中无法访问。 | 
| deleting | 正在删除集群。正在删除的过程中无法访问。 | 
| failing-over | 正在执行从主实例到 Amazon DocumentDB 副本的失效转移。 | 
| inaccessible-encryption-credentials | 无法 AWS KMS 访问用于加密或解密集群的密钥。 | 
| maintenance | 正在对集群应用维护更新。此状态用于 Amazon DocumentDB 预先计划的集群级别维护。 | 
| migrating | 正将集群快照还原给集群。 | 
| migration-failed | 迁移失败。 | 
| modifying | 正在按照客户请求修改集群。 | 
| renaming | 正在按照客户请求重命名集群。 | 
| resetting-master-credentials | 正在按照客户请求重置集群的主凭证。 | 
| upgrading | 集群引擎版本正在升级。 | 

## 监控集群的状态
<a name="monitor-cluster-status"></a>

------
#### [ Using the AWS 管理控制台 ]

使用 AWS 管理控制台 来确定群集的状态时，请按以下步骤操作。

1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)

1. 在导航窗格中，选择**集群**。

1. 在集群导航框中，您将看到**集群标识符**列。您的实例列于集群下，类似于以下屏幕截图。  
![\[“集群”表，显示了如何在集群下嵌套实例。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)

1. 在**集群标识符**列中，找到您感兴趣的实例的名称。然后，要查找该实例的状态，请跨该行阅读至**状态**列，如下所示。  
![\[集群实例，显示了可用状态。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/db-cluster-status-con.png)

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

使用确定 AWS CLI 集群状态时，请使用`describe-db-clusters`操作。以下代码可查找集群 `sample-cluster` 的状态。

对于 Linux、macOS 或 Unix：

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

对于 Windows：

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

此操作的输出将类似于下文。

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

------