

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

# 管理彈性叢集快照
<a name="elastic-manage-snapshots"></a>

建立彈性叢集後，即可取得手動快照。自動備份會在建立彈性叢集快照時建立。

**注意**  
您的彈性叢集必須處於 `Available` 狀態，才能擷取手動快照。

本節說明如何建立、檢視、還原和刪除彈性叢集快照。

下列主題說明如何在使用 Amazon DocumentDB 彈性叢集快照時執行各種任務。

**Topics**
+ [建立手動彈性叢集快照](#elastic-create-snapshot)
+ [檢視彈性叢集快照](#elastic-view-snapshot)
+ [從快照還原彈性叢集](#elastic-restore-snapshot)
+ [複製彈性叢集快照](#elastic-copy-snapshot)
+ [刪除彈性叢集快照](#elastic-delete-snapshot)
+ [管理彈性叢集快照自動備份](#elastic-auto-snapshot)

## 建立手動彈性叢集快照
<a name="elastic-create-snapshot"></a>

在本節中，我們會說明如何使用 AWS 管理主控台 或 AWS CLI 搭配下列指示來建立手動彈性叢集快照。

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

若要使用 建立手動彈性叢集快照 AWS 管理主控台：

1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**  
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。

1. 在 **Snapshots (快照)** 頁面選擇 **Create (建立)**。

1. 在**建立叢集快照**頁面上的**叢集識別符**欄位中，從下拉式清單中選擇您的彈性叢集。

   在**快照識別符**欄位中，輸入彈性叢集的唯一識別符。

   選擇**建立**。  
![\[圖表：彈性叢集建立快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-create-snapshot.png)

**注意**  
或者，您可以前往**叢集**頁面，勾選叢集旁的方塊，然後選擇**動作**，然後**拍攝快照**，以存取**建立**叢集快照對話方塊。

您的彈性叢集快照現在正在佈建。這可能需要幾分鐘的時間才能完成。當狀態`Available`在快照清單中顯示為 時，您可以從**快照**檢視和還原。

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

若要使用 建立手動彈性叢集快照 AWS CLI，請使用 `create-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-name** - 必要項目。您要建立的叢集快照名稱。
+ **--cluster-arn** - 必要項目。您要建立快照之叢集的 ARN 識別符。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic create-cluster-snapshot \
    --snapshot-name sample-snapshot-1 \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```

針對 Windows：

```
aws docdb-elastic create-cluster-snapshot ^
    --snapshot-name sample-snapshot-1 ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```

------

## 檢視彈性叢集快照
<a name="elastic-view-snapshot"></a>

在本節中，我們會說明如何使用 AWS 管理主控台 或 AWS CLI 搭配下列指示來檢視彈性叢集快照資訊。

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

若要使用 檢視特定彈性叢集快照的相關資訊 AWS 管理主控台：

1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**  
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。

1. 在**快照**頁面上，按一下**快照識別符**欄中的名稱，從清單中選擇快照。

1. 在**詳細資訊**中檢視快照的資訊。  
![\[圖表：彈性叢集檢視快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-snapshot-view.png)

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

若要使用 檢視特定彈性叢集快照的相關資訊 AWS CLI，請使用 `get-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-arn** - 必要項目。您想要其資訊的快照 ARN 識別符。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic get-cluster-snapshot \
    --snapshot-arn sampleResourceName
```

針對 Windows：

```
aws docdb-elastic get-cluster-snapshot ^
    --snapshot-arn sampleResourceName
```

若要使用 檢視特定彈性叢集快照的相關資訊 AWS CLI，請使用 `get-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-arn** - 必要項目。您想要其資訊的快照 ARN 識別符。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic get-cluster-snapshot \
    --snapshot-arn sampleResourceName
```

針對 Windows：

```
aws docdb-elastic get-cluster-snapshot ^
    --snapshot-arn sampleResourceName
```

若要使用 檢視所有彈性叢集快照的相關資訊 AWS CLI，請使用 `list-cluster-snapshots`操作搭配下列參數：
+ **--snapshot-type**- 選用。要傳回的叢集快照類型。您可以指定下列其中一個值：
  + `automated` - 傳回 Amazon DocumentDB 為 AWS 您的帳戶自動建立的所有叢集快照。
  + `manual` - 傳回您為 AWS 帳戶手動建立的所有叢集快照。
  + `shared` - 傳回已與 AWS 您的帳戶共用的所有手動叢集快照。
  + `public` - 傳回已標記為公有的所有叢集快照。
+ **--next-token**- 選用。前一個請求提供的選用分頁字符。如果指定此參數，回應只會包含超過此字符的記錄，直到 指定的值為止`max-results`。
+ **--max-results**- 選用。要在回應中包含的最大結果數量。如果存在的結果超過指定的`max-results`值，則會在回應中包含分頁字符 (`next-token`)，以便擷取剩餘的結果。
  + 預設：100
  + 最小值為 20，最大值為 100

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic list-cluster-snapshots \
    --snapshot-type  value \
    --next-token  value \
    --max-results 50
```

針對 Windows：

```
aws docdb-elastic list-cluster-snapshots ^
    --snapshot-type  value ^
    --next-token  value ^
    --max-results 50
```

------

## 從快照還原彈性叢集
<a name="elastic-restore-snapshot"></a>

在本節中，我們會說明如何使用 AWS 管理主控台 或 AWS CLI 搭配下列指示，從快照還原彈性叢集。

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

若要使用 從快照還原彈性叢集 AWS 管理主控台：

1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**  
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。

1. 在快照**識別符**欄中，選擇您要用來還原叢集的快照左側按鈕。

1. 選擇**動作**，再選擇**還原**。  
![\[圖表：從快照進行彈性叢集還原\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-restore-snapshot.png)

1. 在**還原快照**頁面上，在叢集**識別符**欄位中輸入新叢集的名稱。
**注意**  
對於任何手動快照還原，您必須建立新的叢集。

1. 在**虛擬私有雲端 (VPC)** 欄位中，從下拉式清單中選擇 VPC。

1. 對於**子網路**和 **VPC 安全群組**，您可以使用預設值或選取您選擇的三個子網路，以及最多三個 VPC 安全群組 （至少一個）。

1. 如果您滿意此叢集組態，請選擇 **Restore cluster (還原叢集)**，等待叢集還原。

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

若要使用 從快照還原彈性叢集 AWS CLI，請使用 `restore-cluster-from-snapshot`操作搭配下列參數：
+ **--cluster-name** - 必要項目。在建立或上次修改期間輸入的彈性叢集的目前名稱。
+ **--snapshot-arn** - 必要項目。用於還原叢集之快照的 ARN 識別符。
+ **--vpc-security-group-ids**- 選用。要與叢集建立關聯的一或多個 Amazon EC2 和 Amazon Virtual Private Cloud (VPC) 安全群組。
+ **--kms-key-id**- 選用。設定加密叢集的 KMS 金鑰識別符。

  KMS 金鑰識別符是 AWS KMS 加密金鑰的 Amazon Resource Name (ARN)。如果您使用擁有用來加密新叢集之 KMS 加密金鑰的相同 Amazon Web Services 帳戶來建立叢集，您可以使用 KMS 金鑰別名，而不是 KMS 加密金鑰的 ARN。

  如果未在 KmsKeyId 中指定加密金鑰，且 `StorageEncrypted` 參數為 true，Amazon DocumentDB 會使用預設加密金鑰。
+ **--subnet-ids**- 選用。網路子網路 ID。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic restore-cluster-from-snapshot \
     --cluster-name elastic-sample-cluster \
     --snapshot-arn sampleResourceName \
     --vpc-security-group-ids value ec-65f40350 \
     --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
     --subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```

針對 Windows：

```
aws docdb-elastic restore-cluster-from-snapshot ^
     --cluster-name elastic-sample-cluster ^
     --snapshot-arn sampleResourceName ^
     --vpc-security-group-ids value ec-65f40350 ^
     --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
     --subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```

------

## 複製彈性叢集快照
<a name="elastic-copy-snapshot"></a>

在 Amazon DocumentDB 中，您可以在相同區域和相同帳戶中複製手動和自動彈性叢集快照。在本節中，我們會說明如何使用 AWS 管理主控台 或 複製彈性叢集快照 AWS CLI。

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

若要使用 複製彈性叢集快照 AWS 管理主控台：

1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**  
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。

1. 在快照**識別符**欄中，選擇您要複製的快照左側按鈕。

1. 選擇**動作**，然後選擇**複製**。  
![\[圖表：彈性叢集複製快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-copy-snapshot.png)

1. 針對**新快照識別符**，輸入新快照的名稱。

1. 對於**複製標籤**，如果您想要將所有標籤從來源彈性叢集快照複製到目標彈性叢集快照，請勾選此方塊。

1. 針對**加密**，選擇您選擇的預設 AWS KMS 金鑰或 KMS 金鑰。第二個選項可讓您選取已建立的現有 KMS 金鑰，或允許您建立新的 KMS 金鑰。

1. 完成後，請選擇**複製快照**。

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

若要使用 複製彈性叢集快照 AWS CLI，請使用 `copy-cluster-snapshot`操作搭配下列參數：
+ **‐‐source-db-cluster-snapshot-identifier** - 必要項目。正在複製的現有彈性叢集快照的識別符。彈性叢集快照必須存在且處於可用狀態。此參數不區分大小寫。
+ **‐‐target-db-cluster-snapshot-identifier** - 必要項目。要從現有叢集快照建立之新彈性叢集快照的識別符。此參數不區分大小寫。

  目標快照名稱限制條件：
  + 不能是現有快照的名稱。
  + 長度為 【1-63】 個字母、數字或連字號。
  + 第一個字元必須是字母。
  + 不能以連字號結尾，或包含兩個連續連字號。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic copy-cluster-snapshot \
     ‐‐source-cluster-snapshot-arn <sample ARN> \
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot
```

針對 Windows：

```
aws docdb-elastic copy-cluster-snapshot ^
     ‐‐source-cluster-snapshot-arn <sample ARN> ^
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot
```

------

## 刪除彈性叢集快照
<a name="elastic-delete-snapshot"></a>

在本節中，我們會說明如何使用 AWS 管理主控台 或 刪除彈性叢集快照 AWS CLI。

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

若要使用 從快照還原彈性叢集 AWS 管理主控台：

1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**  
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。

1. 在快照**識別符**欄中，選擇您要用來還原叢集的快照左側按鈕。

1. 依序選擇**動作**和**刪除**。  
![\[圖表：彈性叢集刪除快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-delete-snapshot.png)

1. 在**刪除「snapshot-name」快照**對話方塊中，選擇**刪除**。

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

若要使用 刪除彈性叢集快照 AWS CLI，請使用 `delete-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-arn** - 必要項目。用於還原叢集之快照的 ARN 識別符。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic delete-cluster-snapshot \
     --snapshot-arn sampleResourceName
```

針對 Windows：

```
aws docdb-elastic delete-cluster-snapshot ^
     --snapshot-arn sampleResourceName
```

------

## 管理彈性叢集快照自動備份
<a name="elastic-auto-snapshot"></a>

Amazon DocumentDB 會為您的彈性叢集拍攝每日快照。您可以在新的或現有的彈性叢集快照組態中指定偏好的備份時段和備份保留期間。在本節中，我們會說明如何使用 AWS 管理主控台 或 ，在彈性叢集快照中設定自動備份參數 AWS CLI。

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

若要使用 設定新彈性叢集快照的自動備份 AWS 管理主控台：

1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇**叢集**。
**提示**  
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。

1. 在叢集**識別符**欄中，選擇您要變更其備份設定的叢集左側按鈕。

1. 選擇**動作**，然後選擇**修改**。

1. 在**備份**區段中，根據您的備份需求編輯欄位。  
![\[備份窗格的螢幕擷取畫面，顯示設定叢集備份時段的步驟。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-backup.png)

   1. **備份保留期** - 在清單中，選擇在刪除叢集之前保留此叢集自動備份的天數。

   1. **備份時段** - 設定 Amazon DocumentDB 要備份此叢集的每日時間和持續時間。

      1. 如果您想要設定建立備份的時間和持續時間，請選擇**選取視窗**。

         **開始時間** - 在第一個清單中，選擇啟動自動備份的開始時間小時 (UTC)。在第二個清單中，選擇您要自動備份開始進行的時間 (分)。

         **持續時間** - 在清單中，選擇要配置給建立自動備份的時數。

      1. 如果您希望 Amazon DocumentDB 選擇建立備份的時間和持續時間，請選擇**無偏好設定**。

1. 完成時選擇**修改叢集**。

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

若要使用 設定新彈性叢集快照的自動備份 AWS CLI，請使用 `create-cluster-snapshot`操作搭配下列參數：
+ **--preferred-backup-window**- 選用。建立自動備份的每日偏好時間範圍。預設值是從每個 8 小時時段隨機選取的 30 分鐘時段 AWS 區域。

  限制條件：
  + 格式必須為 `hh24:mi-hh24:mi`。
  + 必須以國際標準時間 (UTC) 表示。
  + 不得和慣用的維護時段衝突。
  + 必須至少 30 分鐘。
+ **--backup-retention-period**- 選用。自動備份保留的天數。預設值為 1.

  限制條件：
  + 必須指定最小值 1。
  + 範圍從 1 到 35。

**注意**  
只有在叢集處於「作用中」狀態時，才會進行自動備份。

**注意**  
您也可以使用 `aws docdb-elastic update-cluster`命令修改現有彈性叢集的 `preferred-backup-window`和 `backup-retention-period` 參數。

在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。

下列`create-cluster`範例會建立 Amazon DocumentDB 彈性叢集 *sample-cluster*，其自動備份的保留期間為 *7* 天，而偏好的備份時段為 *18：00-18：30 UTC*。

針對 Linux、macOS 或 Unix：

```
aws docdb-elastic create-cluster \
     --cluster-name sample-cluster \
     --shard-capacity 2 \
     --shard-count 2 \
     --admin-user-name SampleAdmin \
     --auth-type PLAIN_TEXT \
     --admin-user-password SamplePass123! \
     --preferred-backup-window 18:00-18:30 \ 
     --backup-retention-period 7
```

針對 Windows：

```
aws docdb-elastic create-cluster ^
     --cluster-name sample-cluster ^
     --shard-capacity 2 ^
     --shard-count 2 ^
     --admin-user-name SampleAdmin ^
     --auth-type PLAIN_TEXT ^
     --admin-user-password SamplePass123! ^
     --preferred-backup-window 18:00-18:30 ^ 
     --backup-retention-period 7
```

------