本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# CopyDBClusterSnapshot
複製叢集的快照。
若要從共用手動叢集快照複製叢集快照， `SourceDBClusterSnapshotIdentifier` 必須是共用叢集快照的 Amazon Resource Name (ARN)。您只能在相同的 AWS 區域中複製共用資料庫叢集快照，無論是否加密。
若要在複製操作進行後取消複製操作，請在叢集快照處於*複製*狀態`TargetDBClusterSnapshotIdentifier`時刪除 識別的目標叢集快照。
## 請求參數
如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。
** SourceDBClusterSnapshotIdentifier **
要複製之叢集快照的識別碼。此參數不區分大小寫。
限制條件：
+ 必須指定處於*可用*狀態的有效叢集快照。
+ 如果來源叢集快照與 AWS 區域 複本位於相同位置，請指定有效的快照識別符。
+ 如果來源叢集快照位於不同 AWS 區域 或由另一個 AWS 帳戶擁有，請指定快照 ARN。
範例：`my-cluster-snapshot1`
類型：字串
必要：是
** TargetDBClusterSnapshotIdentifier **
要從來源叢集快照建立之新叢集快照的識別碼。此參數不區分大小寫。
限制條件：
+ 必須包含 1 到 63 個字母、數字或連字號。
+ 第一個字元必須是字母。
+ 不能以連字號結尾，或包含兩個連續連字號。
範例：`my-cluster-snapshot2`
類型：字串
必要：是
** CopyTags **
設定為 `true`，將所有標籤從來源叢集快照複製到目標叢集快照，否則為 `false`。預設值為 `false`。
類型：布林值
必要：否
** KmsKeyId **
加密叢集快照的 AWS KMS 金鑰 ID。金鑰 ID AWS KMS 是 AWS KMS 加密金鑰的 Amazon Resource Name (ARN)、 AWS KMS 金鑰識別符或 AWS KMS 金鑰別名。
如果您從 複製加密的叢集快照 AWS 帳戶，您可以指定 的值`KmsKeyId`，以使用新的加密金鑰 AWS KMS 來加密複本。如果您未指定 的值`KmsKeyId`，則會使用與來源叢集快照相同的 AWS KMS 金鑰來加密叢集快照的複本。
如果您複製從另一個 共用的加密叢集快照 AWS 帳戶，則必須指定 的值`KmsKeyId`。
若要將加密的叢集快照複製到另一個叢集快照 AWS 區域，請將 `KmsKeyId`設定為您要用來加密目的地區域中叢集快照複本的 AWS KMS 金鑰 ID。 AWS KMS 加密金鑰專屬於在其中建立 AWS 區域 的 ，您無法在另一個 AWS 區域 區域中使用加密金鑰 AWS 區域。
如果您複製未加密的叢集快照並指定 `KmsKeyId` 參數的值，則會傳回錯誤。
類型：字串
必要：否
** PreSignedUrl **
在 中包含簽章第 4 版簽署的 API 動作請求 AWS 區域 的 URL，`CopyDBClusterSnapshot`其中包含要複製的來源叢集快照。從另一個叢集快照複製時，您必須使用 `PreSignedUrl` 參數 AWS 區域。
如果您使用的是 AWS SDK 工具或 AWS CLI，您可以指定 `SourceRegion`（或`--source-region`用於 AWS CLI)，而不是`PreSignedUrl`手動指定。指定 `SourceRegion` 會自動產生預先簽章的 URL，這是可在來源中執行之操作的有效請求 AWS 區域。
預先簽章的 URL 必須是 `CopyDBClusterSnapshot` API 動作的有效請求，可在包含要複製之叢集快照 AWS 區域 的來源中執行。預先簽章的 URL 請求必須包含下列參數值：
+ `SourceRegion` - 包含要複製之快照的區域 ID。
+ `SourceDBClusterSnapshotIdentifier` - 要複製之加密叢集快照的識別符。此識別碼必須是來源 AWS 區域的 Amazon Resource Name (ARN) 格式。例如，如果您要從 us-east-1 複製加密叢集快照 AWS 區域，則您的 `SourceDBClusterSnapshotIdentifier`看起來會如下所示：`arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`。
+ `TargetDBClusterSnapshotIdentifier` - 要建立新叢集快照的識別符。此參數不區分大小寫。
類型：字串
必要：否
**Tags.Tag.N**
要指派給叢集快照的標籤。
類型：[Tag](API_Tag.md) 物件陣列
必要：否
## 回應元素
服務會傳回下列元素。
** DBClusterSnapshot **
叢集快照的詳細資訊。
類型：[DBClusterSnapshot](API_DBClusterSnapshot.md) 物件
## 錯誤
如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。
** DBClusterSnapshotAlreadyExistsFault **
您已擁有具有指定識別符的叢集快照。
HTTP 狀態碼：400
** DBClusterSnapshotNotFoundFault **
`DBClusterSnapshotIdentifier` 不會參考現有的叢集快照。
HTTP 狀態碼：404
** InvalidDBClusterSnapshotStateFault **
提供的值不是有效的叢集快照狀態。
HTTP 狀態碼：400
** InvalidDBClusterStateFault **
叢集未處於有效狀態。
HTTP 狀態碼：400
** KMSKeyNotAccessibleFault **
存取 AWS KMS 金鑰時發生錯誤。
HTTP 狀態碼：400
** SnapshotQuotaExceeded **
請求會導致您超過允許的快照數量。
HTTP 狀態碼：400
## 另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+ [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CopyDBClusterSnapshot)
+ [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CopyDBClusterSnapshot)