Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CopyClusterSnapshot
<a name="API_elastic_CopyClusterSnapshot"></a>

Kopiert einen Snapshot eines elastischen Clusters.

## Anforderungssyntax
<a name="API_elastic_CopyClusterSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot/snapshotArn/copy HTTP/1.1
Content-type: application/json

{
   "copyTags": boolean,
   "kmsKeyId": "string",
   "tags": { 
      "string" : "string" 
   },
   "targetSnapshotName": "string"
}
```

## URI-Anfrageparameter
<a name="API_elastic_CopyClusterSnapshot_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [snapshotArn](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-uri-snapshotArn"></a>
Der Amazon-Ressourcenname (ARN) -Bezeichner des Elastic Cluster-Snapshots.  
Erforderlich: Ja

## Anforderungstext
<a name="API_elastic_CopyClusterSnapshot_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [targetSnapshotName](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-targetSnapshotName"></a>
Die Kennung des neuen Elastic Cluster-Snapshots, der aus dem Quell-Cluster-Snapshot erstellt werden soll. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.  
Einschränkungen:  
+ Muss zwischen 1 und 63 Buchstaben, Ziffern oder Bindestriche enthalten.
+ Das erste Zeichen muss ein Buchstabe sein.
+ Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.
Beispiel: `elastic-cluster-snapshot-5`   
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.  
Erforderlich: Ja

 ** [copyTags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-copyTags"></a>
Wird auf gesetzt, `true` um alle Tags aus dem Quell-Cluster-Snapshot in den Elastic Cluster-Ziel-Snapshot zu kopieren. Der Standardwert ist `false`.  
Typ: Boolesch  
Erforderlich: Nein

 ** [kmsKeyId](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-kmsKeyId"></a>
Die AWS KMS-Schlüssel-ID für einen verschlüsselten Elastic Cluster-Snapshot. Die AWS KMS-Schlüssel-ID ist der Amazon-Ressourcenname (ARN), die AWS KMS-Schlüssel-ID oder der AWS KMS-Schlüsselalias für den AWS KMS-Verschlüsselungsschlüssel.  
Wenn Sie einen verschlüsselten Elastic Cluster-Snapshot von Ihrem AWS Konto kopieren, können Sie einen Wert angeben, `KmsKeyId` um die Kopie mit einem neuen AWS S KMS-Verschlüsselungsschlüssel zu verschlüsseln. Wenn Sie keinen Wert für angeben`KmsKeyId`, wird die Kopie des Elastic Cluster-Snapshots mit demselben `AWS` KMS-Schlüssel verschlüsselt wie der Elastic Cluster-Quell-Snapshot.  
Wenn Sie einen unverschlüsselten Elastic Cluster-Snapshot kopieren und einen Wert für den `KmsKeyId` Parameter angeben, wird ein Fehler zurückgegeben.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [tags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-tags"></a>
Die Tags, die dem Elastic Cluster-Snapshot zugewiesen werden sollen.  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.  
Schlüssel-Muster: `(?!aws:)[a-zA-Z+-=._:/]+`   
Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

## Antwortsyntax
<a name="API_elastic_CopyClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Antwortelemente
<a name="API_elastic_CopyClusterSnapshot_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [snapshot](#API_elastic_CopyClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-response-snapshot"></a>
Gibt Informationen zu einem bestimmten Elastic Cluster-Snapshot zurück.  
Typ: [ClusterSnapshot](API_elastic_ClusterSnapshot.md) Objekt

## Fehler
<a name="API_elastic_CopyClusterSnapshot_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** AccessDeniedException **   
Eine Ausnahme, die auftritt, wenn nicht genügend Berechtigungen zum Ausführen einer Aktion vorhanden sind.    
 ** message **   
Eine Fehlermeldung, die erklärt, warum der Zugriff verweigert wurde.
HTTP-Statuscode: 403

 ** ConflictException **   
Es gab einen Zugriffskonflikt.    
 ** resourceId **   
Die ID der Ressource, bei der ein Zugriffskonflikt aufgetreten ist.  
 ** resourceType **   
Der Typ der Ressource, bei der ein Zugriffskonflikt aufgetreten ist.
HTTP-Statuscode: 409

 ** InternalServerException **   
Es ist ein interner Serverfehler aufgetreten.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Die angegebene Ressource konnte nicht gefunden werden.    
 ** message **   
Eine Fehlermeldung, die den Fehler beschreibt.  
 ** resourceId **   
Die ID der Ressource, die nicht gefunden werden konnte.  
 ** resourceType **   
Der Typ der Ressource, die nicht gefunden werden konnte.
HTTP-Statuscode: 404

 ** ServiceQuotaExceededException **   
Das Dienstkontingent für die Aktion wurde überschritten.  
HTTP-Statuscode: 402

 ** ThrottlingException **   
ThrottlingException wird ausgelöst, wenn die Anfrage aufgrund einer Drosselung der Anfrage abgelehnt wurde.    
 ** retryAfterSeconds **   
Die Anzahl der Sekunden, die gewartet werden muss, bevor der Vorgang erneut versucht wird.
HTTP-Statuscode: 429

 ** ValidationException **   
Eine Struktur, die eine Validierungsausnahme definiert.    
 ** fieldList **   
Eine Liste der Felder, in denen die Validierungsausnahme aufgetreten ist.  
 ** message **   
Eine Fehlermeldung, die die Validierungsausnahme beschreibt.  
 ** reason **   
Der Grund, warum die Validierungsausnahme aufgetreten ist (einer von `unknownOperation` `cannotParse``fieldValidationFailed`,, oder`other`).
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_elastic_CopyClusterSnapshot_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CopyClusterSnapshot)