翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CopyDBClusterSnapshot
<a name="API_CopyDBClusterSnapshot"></a>

クラスターのスナップショットをコピーします。

手動の共有クラスタースナップショットからクラスタースナップショットをコピーするには、`SourceDBClusterSnapshotIdentifier` が共有クラスタースナップショットの Amazon リソースネーム (ARN) でなければなりません 共有 DB クラスタースナップショットは、暗号化されているかどうかにかかわらず、同じ AWS リージョン内でコピーのみ行えます。

コピー操作の進行後にキャンセルするには、クラスタースナップショットが *[copying]* ステータスの間に `TargetDBClusterSnapshotIdentifier` で識別されるターゲットクラスタースナップショットを削除します。

## リクエストパラメーター
<a name="API_CopyDBClusterSnapshot_RequestParameters"></a>

 すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

 ** SourceDBClusterSnapshotIdentifier **   
コピーするクラスタースナップショットの識別子。このパラメータは大文字と小文字が区別されません。  
制約:  
+ [*available (使用可能)*] 状態の有効なクラスタースナップショットを指定する必要があります。
+ ソースクラスタースナップショットがコピー AWS リージョン と同じ にある場合は、有効なスナップショット識別子を指定します。
+ ソースクラスタースナップショットが別の にある AWS リージョン か、別の AWS アカウントによって所有されている場合は、スナップショット ARN を指定します。
例: `my-cluster-snapshot1`   
タイプ: 文字列  
必須: はい

 ** TargetDBClusterSnapshotIdentifier **   
ソースクラスタースナップショットから作成する新しいクラスタースナップショットの識別子。このパラメータは大文字と小文字が区別されません。  
制約:  
+ 1 ～ 63 の文字、数字またはハイフンを使用する必要があります。
+ 最初の文字は文字である必要があります。
+ ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。
例: `my-cluster-snapshot2`   
タイプ: 文字列  
必須: はい

 ** CopyTags **   
ソースクラスタースナップショットからターゲットクラスタースナップショットにすべてのタグをコピーする場合は `true` に、それ以外の場合は `false` に設定します。デフォルトは `false` です。  
タイプ: ブール値  
必須: いいえ

 ** KmsKeyId **   
暗号化されたクラスタースナップショットの AWS KMS キー ID。キー ID AWS KMS は、Amazon リソースネーム (ARN)、 AWS KMS キー識別子、または AWS KMS 暗号化 AWS KMS キーのキーエイリアスです。  
から暗号化されたクラスタースナップショットをコピーする場合 AWS アカウント、 の値を指定`KmsKeyId`して、新しい暗号化キーでコピーを AWS KMS 暗号化できます。の値を指定しない場合`KmsKeyId`、クラスタースナップショットのコピーはソースクラスタースナップショットと同じ AWS KMS キーで暗号化されます。  
別の から共有されている暗号化されたクラスタースナップショットをコピーする場合は AWS アカウント、 の値を指定する必要があります`KmsKeyId`。  
暗号化されたクラスタースナップショットを別の にコピーするには AWS リージョン、 を送信先リージョンのクラスタースナップショットのコピーを暗号化するために使用する AWS KMS キー ID `KmsKeyId`に設定します。 AWS KMS 暗号化キーは、作成された AWS リージョン に固有であり、 AWS リージョン 別の の暗号化キーを使用することはできません AWS リージョン。  
暗号化されていないクラスタースナップショットをコピーして `KmsKeyId` パラメータに値を指定すると、エラーが返されます。  
タイプ: 文字列  
必須: いいえ

 ** PreSignedUrl **   
コピーするソースクラスタースナップショットを含む の API アクションの署名バージョン 4 の署名付きリクエスト`CopyDBClusterSnapshot` AWS リージョン を含む URL。クラスタースナップショットを別の AWS リージョンからコピーする場合は、`PreSignedUrl` パラメータを使用する必要があります。  
 AWS SDK ツールまたは を使用している場合は AWS CLI、 `PreSignedUrl` を手動で指定する代わりに `SourceRegion` ( `--source-region`の場合は AWS CLI) を指定できます。`SourceRegion` を指定すると、ソース AWS リージョンで実行できる操作の有効なリクエストである署名付き URL が自動生成されます。  
署名付き URL は、コピーするクラスタースナップショット AWS リージョン を含むソースで実行できる `CopyDBClusterSnapshot` API アクションの有効なリクエストである必要があります。署名付き URL リクエストでは、以下のパラメータ値を指定する必要があります。  
+  `SourceRegion` - コピーするスナップショットを含むリージョンの ID。
+  `SourceDBClusterSnapshotIdentifier` - コピーする暗号化されたクラスタースナップショットの識別子。この識別子は、ソース AWS リージョンの Amazon リソースネーム (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) オブジェクトの配列  
必須: いいえ

## レスポンス要素
<a name="API_CopyDBClusterSnapshot_ResponseElements"></a>

以下の要素がサービスによって返されます。

 ** DBClusterSnapshot **   
クラスタースナップショットに関する詳細情報。  
型: [DBClusterSnapshot](API_DBClusterSnapshot.md) オブジェクト

## エラー
<a name="API_CopyDBClusterSnapshot_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** DBClusterSnapshotAlreadyExistsFault **   
指定された識別子を持つクラスタースナップショットをすでに持っています。  
HTTP ステータスコード: 400

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier` は既存のクラスタースナップショットを参照していません。  
HTTP ステータスコード: 404

 ** InvalidDBClusterSnapshotStateFault **   
指定された値は有効なクラスタースナップショット状態ではありません。  
HTTP ステータスコード: 400

 ** InvalidDBClusterStateFault **   
クラスターは有効な状態ではありません。  
HTTP ステータスコード: 400

 ** KMSKeyNotAccessibleFault **   
 AWS KMS キーへのアクセス中にエラーが発生しました。  
HTTP ステータスコード: 400

 ** SnapshotQuotaExceeded **   
リクエストにより、スナップショットの許容数を超過します。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CopyDBClusterSnapshot_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CopyDBClusterSnapshot)