CopyDBClusterSnapshot - Amazon DocumentDB
AnforderungsparameterAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

CopyDBClusterSnapshot

Kopiert einen Snapshot eines Clusters.

Um einen Cluster-Snapshot aus einem gemeinsam genutzten manuellen Cluster-Snapshot zu kopieren, SourceDBClusterSnapshotIdentifier muss es sich um den Amazon-Ressourcennamen (ARN) des gemeinsam genutzten Cluster-Snapshots handeln. Sie können einen freigegebenen DB-Cluster-Snapshot, ob verschlüsselt oder nicht, nur in dieselbe AWS-Region kopieren.

Um den Kopiervorgang abzubrechen, nachdem er ausgeführt wurde, löschen Sie den Ziel-Cluster-Snapshot, der identifiziert wurde, TargetDBClusterSnapshotIdentifier solange sich dieser Cluster-Snapshot im Kopierstatus befindet.

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

SourceDBClusterSnapshotIdentifier

Die ID des zu kopierenden Cluster-Snapshots. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Einschränkungen:

  • Es muss ein gültiger Cluster-Snapshot mit verfügbarem Status angegeben werden.

  • Wenn sich der Quell-Cluster-Snapshot in derselben Datei AWS-Region wie die Kopie befindet, geben Sie eine gültige Snapshot-ID an.

  • Wenn sich der Quell-Cluster-Snapshot in einem anderen Konto befindet AWS-Region oder einem anderen AWS Konto gehört, geben Sie den Snapshot-ARN an.

Beispiel: my-cluster-snapshot1

Typ: Zeichenfolge

Erforderlich: Ja

TargetDBClusterSnapshotIdentifier

Die ID des neuen 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: my-cluster-snapshot2

Typ: Zeichenfolge

Erforderlich: Ja

CopyTags

Wird auf gesetzt, true um alle Tags aus dem Quell-Cluster-Snapshot in den Ziel-Cluster-Snapshot zu kopieren, andernfalls. false Der Standardwert ist false.

Typ: Boolesch

Erforderlich: Nein

KmsKeyId

Die AWS KMS Schlüssel-ID für einen verschlüsselten 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 Cluster-Snapshot von Ihrem kopieren AWS-Konto, können Sie einen Wert angeben, KmsKeyId um die Kopie mit einem neuen AWS KMS Verschlüsselungsschlüssel zu verschlüsseln. Wenn Sie keinen Wert für angebenKmsKeyId, wird die Kopie des Cluster-Snapshots mit demselben AWS KMS Schlüssel verschlüsselt wie der Quell-Cluster-Snapshot.

Wenn Sie einen verschlüsselten Cluster-Snapshot, der gemeinsam genutzt wird AWS-Konto, von einem anderen kopieren, müssen Sie einen Wert für angebenKmsKeyId.

Um einen verschlüsselten Cluster-Snapshot in einen anderen KmsKeyId zu kopieren AWS-Region, geben Sie die AWS KMS Schlüssel-ID ein, mit der Sie die Kopie des Cluster-Snapshots in der Zielregion verschlüsseln möchten. AWS KMS Verschlüsselungsschlüssel sind spezifisch für AWS-Region das Land, in dem sie erstellt wurden, und Sie können keine Verschlüsselungsschlüssel von einem AWS-Region in einem anderen AWS-Region verwenden.

Wenn Sie einen unverschlüsselten Cluster-Snapshot kopieren und einen Wert für den KmsKeyId Parameter angeben, wird ein Fehler zurückgegeben.

Typ: Zeichenfolge

Erforderlich: Nein

PreSignedUrl

Die URL, die eine mit Signature Version 4 signierte Anfrage für die CopyDBClusterSnapshot API-Aktion enthält AWS-Region , die den zu kopierenden Quell-Cluster-Snapshot enthält. Sie müssen den PreSignedUrl Parameter verwenden, wenn Sie einen Cluster-Snapshot von einem anderen kopieren AWS-Region.

Wenn Sie ein AWS SDK-Tool oder das verwenden AWS CLI, können Sie SourceRegion (oder --source-region für AWS CLI) angeben, anstatt es PreSignedUrl manuell anzugeben. Durch die Angabe wird SourceRegion automatisch eine vorsignierte URL generiert, bei der es sich um eine gültige Anforderung für den Vorgang handelt, die in der Quelle ausgeführt werden kann. AWS-Region

Bei der vorsignierten URL muss es sich um eine gültige Anforderung für die CopyDBClusterSnapshot API-Aktion handeln, die in der Quelle ausgeführt werden kann AWS-Region , die den zu kopierenden Cluster-Snapshot enthält. Die vorsignierte URL-Anforderung muss die folgenden Parameterwerte enthalten:

  • SourceRegion- Die ID der Region, die den zu kopierenden Snapshot enthält.

  • SourceDBClusterSnapshotIdentifier— Die Kennung für den verschlüsselten Cluster-Snapshot, der kopiert werden soll. Dieser Bezeichner muss im ARN-Format (Amazon-Ressourcenname) der Quell- AWS-Region angegeben werden. Wenn Sie beispielsweise einen verschlüsselten Cluster-Snapshot von us-east-1 kopieren AWS-Region, SourceDBClusterSnapshotIdentifier sieht Ihr etwa wie folgt aus:. arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot

  • TargetDBClusterSnapshotIdentifier- Die Kennung für den neuen Cluster-Snapshot, der erstellt werden soll. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Typ: Zeichenfolge

Erforderlich: Nein

Stichworte.Tag.N

Die Tags, die dem Cluster-Snapshot zugewiesen werden sollen.

Typ: Array von Tag-Objekten

Erforderlich: Nein

Antwortelemente

Das folgende Element wird vom Dienst zurückgegeben.

DBClusterSnapshot

Detaillierte Informationen zu einem Cluster-Snapshot.

Typ: DBClusterSnapshot Objekt

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

DBClusterSnapshotAlreadyExistsFault

Sie haben bereits einen Cluster-Snapshot mit der angegebenen Kennung.

HTTP Status Code: 400

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifierbezieht sich nicht auf einen vorhandenen Cluster-Snapshot.

HTTP Status Code: 404

InvalidDBClusterSnapshotStateFault

Der angegebene Wert ist kein gültiger Cluster-Snapshot-Status.

HTTP Status Code: 400

InvalidDBClusterStateFault

Der Cluster befindet sich nicht in einem gültigen Zustand.

HTTP Status Code: 400

KMSKeyNotAccessibleFault

Beim Zugriff auf einen AWS KMS Schlüssel ist ein Fehler aufgetreten.

HTTP Status Code: 400

SnapshotQuotaExceeded

Die Anfrage würde dazu führen, dass Sie die zulässige Anzahl von Snapshots überschreiten.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: