本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 監控 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>

下表列出叢集狀態的有效值。


| 叢集狀態 | Description | 
| --- | --- | 
| 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 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇**叢集**。

1. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。  
![\[叢集資料表顯示如何在叢集下巢狀化執行個體。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)

1. 在**叢集識別符**欄中，尋找您感興趣的執行個體名稱。然後，若要尋找執行個體的狀態，請讀取該列中的**狀態**欄，如下所示。  
![\[顯示可用狀態的叢集執行個體。\]](http://docs.aws.amazon.com/zh_tw/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"
    ]
]
```

------