Neptune Snapshots-API - Amazon Neptune
CreateDBClusterSnapshotDeleteDBClusterSnapshotCopyDBClusterSnapshotModifyDBClusterSnapshotAttributeRestoreDBClusterFromSnapshotRestoreDBClusterToPointInTimeDescribeDBClusterSnapshotsDescribeDBClusterSnapshotAttributes________________________DBClusterSnapshotDBClusterSnapshotAttributeDBClusterSnapshotAttributesResult

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.

Neptune Snapshots-API

Aktionen:

Strukturen:

CreateDBClusterSnapshot (Aktion)

        Der AWS CLI-Name für diese API lautet: create-db-cluster-snapshot.

Erstellt einen Snapshot eines DB-Clusters.

Anforderung

  • DBClusterIdentifier  (in der CLI: --db-cluster-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des DB-Clusters, für den ein Snapshot erstellt werden soll. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

    Einschränkungen:

    • Muss der Kennung eines vorhandenen DBCluster-Werts entsprechen.

    Beispiel: my-cluster1

  • DBClusterSnapshotIdentifier  (in der CLI: --db-cluster-snapshot-identifier) – Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des DB-Cluster-Snapshots. Dieser Parameter wird als Zeichenfolge in Kleinbuchstaben gespeichert.

    Einschränkungen:

    • Muss zwischen 1 und 63 Buchstaben, Ziffern oder Bindestriche enthalten.

    • Muss mit einem Buchstaben beginnen.

    • Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.

    Beispiel: my-cluster1-snapshot1

  • Tags  (in der CLI: --tags) –  Ein Array von Tag Objekten.

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

Antwort

Enthält die Details für einen Amazon Neptune-DB-Cluster-Snapshot.

Dieser Datentyp wird als Antwortelement in der Aktion DescribeDBClusterSnapshots (Aktion) verwendet.

  • AllocatedStorage – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Legt die Größe des zugewiesenen Speichers in Gibibyte (GiB) fest.

  • AvailabilityZones   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Liste der EC2-Availability Zones bereit, in denen Instances im DB-Cluster-Snapshot wiederhergestellt werden können.

  • ClusterCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den Zeitpunkt an, an dem der DB-Cluster erstellt wurde, in UTC (Universal Coordinated Time).

  • DBClusterIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die DB-Cluster-Kennung des DB-Clusters fest, anhand dessen dieser DB-Cluster-Snapshot erstellt wurde.

  • DBClusterSnapshotArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Amazon-Ressourcenname (ARN) für den DB-Cluster-Snapshot.

  • DBClusterSnapshotIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die Kennung für den DB-Cluster-Snapshot fest. Muss mit der Kennung eines vorhandenen Snapshots übereinstimmen.

    Nachdem Sie einen DB-Cluster mit einem DBClusterSnapshotIdentifier wiederhergestellt haben, müssen Sie denselben DBClusterSnapshotIdentifier für zukünftige Aktualisierungen des DB-Clusters angeben. Wenn Sie diese Eigenschaft für eine Aktualisierung angeben, wird der DB-Cluster nicht erneut aus dem Snapshot wiederhergestellt und die Daten in der Datenbank werden nicht geändert.

    Sollten Sie die DBClusterSnapshotIdentifier-Eigenschaft jedoch nicht angeben, wird ein leerer DB-Cluster erstellt und der ursprüngliche DB-Cluster wird gelöscht. Wenn Sie eine Eigenschaft angeben, die sich von der vorherigen Snapshot-Eigenschaft zur Wiederherstellung unterscheidet, wird der DB-Cluster aus dem Snapshot wiederhergestellt, der durch den DBClusterSnapshotIdentifier angegeben wurde, und der ursprüngliche DB-Cluster gelöscht.

  • Engine   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Namen der Datenbank-Engine fest.

  • EngineVersion   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Version der Datenbank-Engine für diesen DB-Cluster-Snapshot bereit.

  • IAMDatabaseAuthenticationEnabled – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Dies ist „true“, wenn die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbank-Konten aktiviert ist. Andernfalls „false“.

  • KmsKeyId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wenn StorageEncrypted „true“ ist, ist dies die Amazon-KMS-Schlüsselkennung für den verschlüsselten DB-Cluster-Snapshot.

  • LicenseModel   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Lizenzmodellinformationen für diesen DB-Cluster-Snapshot bereit.

  • PercentProgress – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt einen Prozentsatz der Daten an, die laut Schätzung bereits übertragen wurden.

  • Port – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt den Port an, den der DB-Cluster zum Zeitpunkt des Snapshots überwacht hat.

  • SnapshotCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt das Datum und die Uhrzeit der Erstellung des Snapshots in koordinierter Weltzeit (UTC) an.

  • SnapshotType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt den Typ des DB-Cluster-Snapshots bereit.

  • SourceDBClusterSnapshotArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Falls der DB-Cluster-Snapshot von einem Quell-DB-Cluster-Snapshot kopiert wurde, der Amazon-Ressourcenname (ARN) für den Quell-DB-Cluster-Snapshot, andernfalls ein Null-Wert.

  • Status   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Status dieses DB-Cluster-Snapshots fest.

  • StorageEncrypted – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster-Snapshot verschlüsselt ist.

  • StorageType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Speichertyp, der dem DB-Cluster-Snapshot zugeordnet ist.

  • VpcId   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die VPC-ID bereit, die dem DB-Cluster-Snapshot zugeordnet ist.

Fehler

DeleteDBClusterSnapshot (Aktion)

        Der AWS CLI-Name für diese API lautet: delete-db-cluster-snapshot.

Löscht einen DB-Cluster-Snapshot. Wenn der Snapshot gerade kopiert wird, wird der Kopiervorgang beendet.

Anmerkung

Der DB-Cluster-Snapshot muss sich im Status available befinden, um gelöscht werden zu können.

Anforderung

  • DBClusterSnapshotIdentifier  (in der CLI: --db-cluster-snapshot-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des DB-Cluster-Snapshots, der gelöscht werden soll.

    Einschränkungen: Es muss der Name eines bestehenden DB-Cluster-Snapshots im Status available sein.

Antwort

Enthält die Details für einen Amazon Neptune-DB-Cluster-Snapshot.

Dieser Datentyp wird als Antwortelement in der Aktion DescribeDBClusterSnapshots (Aktion) verwendet.

  • AllocatedStorage – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Legt die Größe des zugewiesenen Speichers in Gibibyte (GiB) fest.

  • AvailabilityZones   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Liste der EC2-Availability Zones bereit, in denen Instances im DB-Cluster-Snapshot wiederhergestellt werden können.

  • ClusterCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den Zeitpunkt an, an dem der DB-Cluster erstellt wurde, in UTC (Universal Coordinated Time).

  • DBClusterIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die DB-Cluster-Kennung des DB-Clusters fest, anhand dessen dieser DB-Cluster-Snapshot erstellt wurde.

  • DBClusterSnapshotArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Amazon-Ressourcenname (ARN) für den DB-Cluster-Snapshot.

  • DBClusterSnapshotIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die Kennung für den DB-Cluster-Snapshot fest. Muss mit der Kennung eines vorhandenen Snapshots übereinstimmen.

    Nachdem Sie einen DB-Cluster mit einem DBClusterSnapshotIdentifier wiederhergestellt haben, müssen Sie denselben DBClusterSnapshotIdentifier für zukünftige Aktualisierungen des DB-Clusters angeben. Wenn Sie diese Eigenschaft für eine Aktualisierung angeben, wird der DB-Cluster nicht erneut aus dem Snapshot wiederhergestellt und die Daten in der Datenbank werden nicht geändert.

    Sollten Sie die DBClusterSnapshotIdentifier-Eigenschaft jedoch nicht angeben, wird ein leerer DB-Cluster erstellt und der ursprüngliche DB-Cluster wird gelöscht. Wenn Sie eine Eigenschaft angeben, die sich von der vorherigen Snapshot-Eigenschaft zur Wiederherstellung unterscheidet, wird der DB-Cluster aus dem Snapshot wiederhergestellt, der durch den DBClusterSnapshotIdentifier angegeben wurde, und der ursprüngliche DB-Cluster gelöscht.

  • Engine   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Namen der Datenbank-Engine fest.

  • EngineVersion   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Version der Datenbank-Engine für diesen DB-Cluster-Snapshot bereit.

  • IAMDatabaseAuthenticationEnabled – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Dies ist „true“, wenn die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbank-Konten aktiviert ist. Andernfalls „false“.

  • KmsKeyId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wenn StorageEncrypted „true“ ist, ist dies die Amazon-KMS-Schlüsselkennung für den verschlüsselten DB-Cluster-Snapshot.

  • LicenseModel   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Lizenzmodellinformationen für diesen DB-Cluster-Snapshot bereit.

  • PercentProgress – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt einen Prozentsatz der Daten an, die laut Schätzung bereits übertragen wurden.

  • Port – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt den Port an, den der DB-Cluster zum Zeitpunkt des Snapshots überwacht hat.

  • SnapshotCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt das Datum und die Uhrzeit der Erstellung des Snapshots in koordinierter Weltzeit (UTC) an.

  • SnapshotType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt den Typ des DB-Cluster-Snapshots bereit.

  • SourceDBClusterSnapshotArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Falls der DB-Cluster-Snapshot von einem Quell-DB-Cluster-Snapshot kopiert wurde, der Amazon-Ressourcenname (ARN) für den Quell-DB-Cluster-Snapshot, andernfalls ein Null-Wert.

  • Status   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Status dieses DB-Cluster-Snapshots fest.

  • StorageEncrypted – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster-Snapshot verschlüsselt ist.

  • StorageType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Speichertyp, der dem DB-Cluster-Snapshot zugeordnet ist.

  • VpcId   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die VPC-ID bereit, die dem DB-Cluster-Snapshot zugeordnet ist.

Fehler

CopyDBClusterSnapshot (Aktion)

        Der AWS CLI-Name für diese API lautet: copy-db-cluster-snapshot.

Kopiert einen Snapshot eines DB-Clusters.

Um einen DB-Cluster-Snapshot von einem freigegebenen manuellen DB-Cluster-Snapshot zu kopieren, muss SourceDBClusterSnapshotIdentifier der Amazon-Ressourcenname (ARN) des freigegebenen DB-Snapshots sein.

Anforderung

  • CopyTags  (in der CLI: --copy-tags) – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    "True", um alle Tags aus dem Quell-DB-Cluster-Snapshot in den Ziel-DB-Cluster-Snapshot zu kopieren, andernfalls "false". Der Standardwert lautet „false“.

  • KmsKeyId   (in der CLI: --kms-key-id) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Schlüssel-ID von Amazon KMS für einen verschlüsselten DB-Snapshot. Die KMS-Schlüssel-ID ist der Amazon-Ressourcenname (ARN), der KMS-Schlüsselbezeichner oder der KMS-Schlüsselalias für den KMS-Verschlüsselungsschlüssel.

    Wenn Sie einen verschlüsselten DB-Cluster-Snapshot aus Ihrem Amazon-Konto kopieren, können Sie für KmsKeyId einen Wert angeben, damit die Kopie mit einem neuen KMS-Verschlüsselungsschlüssel verschlüsselt wird. Wenn Sie keinen Wert für KmsKeyId angeben, wird die Kopie des DB-Cluster-Snapshots mit demselben KMS-Schlüssel wie der Quell-DB-Cluster-Snapshot verschlüsselt.

    Wenn Sie einen verschlüsselten DB-Cluster-Snapshot kopieren, der von einem anderen Amazon-Konto freigegeben wurde, müssen Sie einen Wert für KmsKeyId angeben.

    KMS-Schlüssel sind spezifisch für die Region, in der sie erstellt wurden, und Sie können keine Verschlüsselungsschlüssel aus einer Amazon-Region in einer anderen AmazonRegion verwenden.

    Sie können einen unverschlüsselten DB-Cluster-Snapshot nicht verschlüsseln, wenn Sie ihn kopieren. Wenn Sie versuchen, einen unverschlüsselten DB-Cluster-Snapshot zu kopieren und einen Wert für den Parameter KmsKeyId anzugeben, wird ein Fehler zurückgegeben.

  • PreSignedUrl   (in der CLI: --pre-signed-url) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wird derzeit nicht unterstützt.

  • SourceDBClusterSnapshotIdentifier  (in der CLI: --source-db-cluster-snapshot-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

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

    Einschränkungen:

    • Es ist ein gültiger System-Snapshot im Status "available" erforderlich.

    • Geben Sie eine gültige DB-Snapshot-Kennung an.

    Beispiel: my-cluster-snapshot1

  • Tags  (in der CLI: --tags) –  Ein Array von Tag Objekten.

    Die Tags für die Zuweisung zur neuen DB-Cluster-Snapshot-Kopie.

  • TargetDBClusterSnapshotIdentifier  (in der CLI: --target-db-cluster-snapshot-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des neuen DB-Cluster-Snapshots, der aus dem Quell-DB-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.

    • Muss mit einem Buchstaben beginnen.

    • Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.

    Beispiel: my-cluster-snapshot2

Antwort

Enthält die Details für einen Amazon Neptune-DB-Cluster-Snapshot.

Dieser Datentyp wird als Antwortelement in der Aktion DescribeDBClusterSnapshots (Aktion) verwendet.

  • AllocatedStorage – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Legt die Größe des zugewiesenen Speichers in Gibibyte (GiB) fest.

  • AvailabilityZones   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Liste der EC2-Availability Zones bereit, in denen Instances im DB-Cluster-Snapshot wiederhergestellt werden können.

  • ClusterCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den Zeitpunkt an, an dem der DB-Cluster erstellt wurde, in UTC (Universal Coordinated Time).

  • DBClusterIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die DB-Cluster-Kennung des DB-Clusters fest, anhand dessen dieser DB-Cluster-Snapshot erstellt wurde.

  • DBClusterSnapshotArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Amazon-Ressourcenname (ARN) für den DB-Cluster-Snapshot.

  • DBClusterSnapshotIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die Kennung für den DB-Cluster-Snapshot fest. Muss mit der Kennung eines vorhandenen Snapshots übereinstimmen.

    Nachdem Sie einen DB-Cluster mit einem DBClusterSnapshotIdentifier wiederhergestellt haben, müssen Sie denselben DBClusterSnapshotIdentifier für zukünftige Aktualisierungen des DB-Clusters angeben. Wenn Sie diese Eigenschaft für eine Aktualisierung angeben, wird der DB-Cluster nicht erneut aus dem Snapshot wiederhergestellt und die Daten in der Datenbank werden nicht geändert.

    Sollten Sie die DBClusterSnapshotIdentifier-Eigenschaft jedoch nicht angeben, wird ein leerer DB-Cluster erstellt und der ursprüngliche DB-Cluster wird gelöscht. Wenn Sie eine Eigenschaft angeben, die sich von der vorherigen Snapshot-Eigenschaft zur Wiederherstellung unterscheidet, wird der DB-Cluster aus dem Snapshot wiederhergestellt, der durch den DBClusterSnapshotIdentifier angegeben wurde, und der ursprüngliche DB-Cluster gelöscht.

  • Engine   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Namen der Datenbank-Engine fest.

  • EngineVersion   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Version der Datenbank-Engine für diesen DB-Cluster-Snapshot bereit.

  • IAMDatabaseAuthenticationEnabled – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Dies ist „true“, wenn die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbank-Konten aktiviert ist. Andernfalls „false“.

  • KmsKeyId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wenn StorageEncrypted „true“ ist, ist dies die Amazon-KMS-Schlüsselkennung für den verschlüsselten DB-Cluster-Snapshot.

  • LicenseModel   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Lizenzmodellinformationen für diesen DB-Cluster-Snapshot bereit.

  • PercentProgress – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt einen Prozentsatz der Daten an, die laut Schätzung bereits übertragen wurden.

  • Port – eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt den Port an, den der DB-Cluster zum Zeitpunkt des Snapshots überwacht hat.

  • SnapshotCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt das Datum und die Uhrzeit der Erstellung des Snapshots in koordinierter Weltzeit (UTC) an.

  • SnapshotType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt den Typ des DB-Cluster-Snapshots bereit.

  • SourceDBClusterSnapshotArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Falls der DB-Cluster-Snapshot von einem Quell-DB-Cluster-Snapshot kopiert wurde, der Amazon-Ressourcenname (ARN) für den Quell-DB-Cluster-Snapshot, andernfalls ein Null-Wert.

  • Status   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Status dieses DB-Cluster-Snapshots fest.

  • StorageEncrypted – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster-Snapshot verschlüsselt ist.

  • StorageType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Speichertyp, der dem DB-Cluster-Snapshot zugeordnet ist.

  • VpcId   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die VPC-ID bereit, die dem DB-Cluster-Snapshot zugeordnet ist.

Fehler

ModifyDBClusterSnapshotAttribute (Aktion)

        Der AWS CLI-Name für diese API lautet: modify-db-cluster-snapshot-attribute.

Fügt ein Attribut und Werte zu einem manuellen DB-Cluster-Snapshot hinzu oder entfernt ein Attribut und Werte daraus.

Um einen manuellen DB-Cluster-Snapshot mit anderen Amazon-Konten zu teilen, legen Sie restore als AttributeName fest und verwenden Sie den Parameter ValuesToAdd, um eine Liste von IDs der Amazon-Konten hinzuzufügen, die dazu autorisiert sind, den manuellen DB-Cluster-Snapshot wiederherzustellen. Verwenden Sie den Wert all, um den manuellen DB-Cluster-Snapshot zu veröffentlichen. Dies bedeutet, dass er von allen Amazon-Konten kopiert oder wiederhergestellt werden kann. Fügen Sie den Wert all zu keinem manuellen DB-Cluster-Snapshot hinzu, der private Informationen enthält, die nicht für alle Amazon-Konten verfügbar sein sollen. Wenn ein manueller DB-Cluster-Snapshot verschlüsselt ist, kann er freigegeben werden, jedoch nur durch Angabe einer Liste von autorisierten Amazon-Konto-IDs für den Parameter ValuesToAdd. Sie können in diesem Fall all nicht als Wert für diesen Parameter verwenden.

Um anzuzeigen, welche Amazon-Konten Zugriff für das Kopieren oder Wiederherstellen eines manuellen DB-Cluster-Snapshots haben, oder ob ein manueller DB-Cluster-Snapshot öffentlich oder privat ist, verwenden Sie die API-Aktion DescribeDBClusterSnapshotAttributes (Aktion).

Anforderung

  • AttributeName  (in der CLI: --attribute-name) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name des zu ändernden DB-Cluster-Snapshot-Attributs.

    Um die Autorisierung für andere Amazon-Konten zu verwalten, um einen manuellen DB-Cluster-Snapshot zu kopieren oder wiederherzustellen, setzen Sie diesen Wert auf restore.

  • DBClusterSnapshotIdentifier  (in der CLI: --db-cluster-snapshot-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung für den DB-Cluster-Snapshot, für den die Attribute geändert werden sollen.

  • ValuesToAdd   (in der CLI: --values-to-add) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine Liste von DB-Cluster-Snapshot-Attributen zum Hinzufügen zu dem Attribut, das durch AttributeName festgelegt ist.

    Um andere Amazon-Konten zum Kopieren oder Wiederherstellen eines manuellen DB-Cluster-Snapshots zu autorisieren, legen Sie diese Liste so fest, dass sie eine oder mehrere Amazon-Konto-IDs enthält, oder wählen Sie all, damit der manuelle DB-Cluster-Snapshot von jedem beliebigen Amazon-Konto wiederhergestellt werden kann. Fügen Sie den Wert all zu keinem manuellen DB-Cluster-Snapshot hinzu, der private Informationen enthält, die nicht für alle Amazon-Konten verfügbar sein sollen.

  • ValuesToRemove   (in der CLI: --values-to-remove) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine Liste von DB-Cluster-Snapshot-Attributen zum Entfernen von dem Attribut, das durch AttributeName festgelegt ist.

    Um die Autorisierung anderer Amazon-Konten zum Kopieren oder Wiederherstellen eines manuellen DB-Cluster-Snapshots zu entfernen, legen Sie diese Liste so fest, dass sie eine oder mehrere Amazon-Konto-Kennungen enthält, oder wählen Sie all, um die Autorisierung zum Kopieren oder Wiederherstellen des manuellen DB-Cluster-Snapshots von jedem Amazon-Konto zu entfernen. Wenn Sie all festlegen, kann ein Amazon-Konto, dessen Konto-ID explizit zum Attribut restore hinzugefügt wird, noch immer einen manuellen DB-Cluster-Snapshot kopieren oder wiederherstellen.

Antwort

Enthält die Ergebnisse eines erfolgreichen Aufrufs an die API-Aktion DescribeDBClusterSnapshotAttributes (Aktion).

Manuelle DB-Cluster-Snapshot-Attribute werden verwendet, um andere Amazon-Konten zu autorisieren und einen manuellen DB-Cluster-Snapshot zu kopieren oder wiederherzustellen. Weitere Informationen finden Sie in der API-Aktion ModifyDBClusterSnapshotAttribute (Aktion).

  • DBClusterSnapshotAttributes – Ein Array mit DBClusterSnapshotAttribute-Objekten.

    Die Liste der Attribute und Werte für den manuellen DB-Cluster-Snapshot.

  • DBClusterSnapshotIdentifier – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des manuellen DB-Cluster-Snapshots, für den die Attribute gelten.

Fehler

RestoreDBClusterFromSnapshot (Aktion)

        Der AWS CLI-Name für diese API lautet: restore-db-cluster-from-snapshot.

Erstellt einen neuen DB-Cluster aus einem DB-Snapshot oder einem DB-Cluster-Snapshot.

Wenn ein DB-Snapshot angegeben ist, wird der Ziel-DB-Cluster mit einer Standard-Konfiguration und Standard-Sicherheitsgruppe aus dem Quell-DB-Snapshot erstellt.

Wenn ein DB-Cluster-Snapshot angegeben ist, wird der Ziel-DB-Cluster vom Quell-DB-Cluster-Wiederherstellungspunkt mit der gleichen Konfiguration wie der ursprüngliche Quell-DB-Cluster erstellt, mit der Ausnahme, dass der neue DB-Cluster mit der Standard-Sicherheitsgruppe erstellt wird.

Anforderung

  • AvailabilityZones  (in der CLI: --availability-zones) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Liste der EC2 Availability Zones bereit, in denen Instances im wiederhergestellten DB-Cluster erstellt werden können.

  • CopyTagsToSnapshot  (in der CLI: --copy-tags-to-snapshot) – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Wenn auf true gesetzt, werden Tags in jeden Snapshot des wiederhergestellten DB-Clusters kopiert, der erstellt wird.

  • DatabaseName   (in der CLI: --database-name) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Nicht unterstützt

  • DBClusterIdentifier  (in der CLI: --db-cluster-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name des DB-Clusters, der aus dem DB-Snapshot oder dem DB-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.

    • Muss mit einem Buchstaben beginnen

    • Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten

    Beispiel: my-snapshot-id

  • DBClusterParameterGroupName   (in der CLI: --db-cluster-parameter-group-name) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name der DB-Cluster-Parametergruppe, die mit dem neuen DB-Cluster verknüpft werden soll.

    Einschränkungen:

    • Wenn das Argument angegeben wird, muss der Wert mit dem Namen einer vorhandenen DBClusterParameterGroup übereinstimmen.

  • DBSubnetGroupName   (in der CLI: --db-subnet-group-name) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name der DB-Subnetz-Gruppe, die für den neuen DB-Cluster verwendet werden soll.

    Einschränkungen: Falls angegeben, muss der Wert mit dem Namen einer vorhandenen DBSubnetGroup übereinstimmen.

    Beispiel: mySubnetgroup

  • DeletionProtection  (in der CLI: --deletion-protection) – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Ein Wert, der angibt, ob der Löschschutz des DB-Clusters aktiviert ist. Die Datenbank kann nicht gelöscht werden, wenn der Löschschutz aktiviert ist. Der Löschschutz ist standardmäßig deaktiviert.

  • EnableCloudwatchLogsExports   (in der CLI: --enable-cloudwatch-logs-exports) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Liste der Protokolle, die der wiederhergestellte DB-Cluster zu Amazon CloudWatch Logs exportieren soll.

  • EnableIAMDatabaseAuthentication  (in der CLI: --enable-iam-database-authentication) – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    „True“, um die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbankkonten zu aktivieren; andernfalls „false“.

    Standard: false

  • Engine  (in der CLI: --engine) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Datenbank-Engine, die für den neuen DB-Cluster verwendet werden soll.

    Standardmäßig: Gleich wie Quelle

    Einschränkung: Muss mit der Engine der Quelle kompatibel sein

  • EngineVersion   (in der CLI: --engine-version) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Version der Datenbank-Engine, die für den neuen DB-Cluster verwendet werden soll.

  • KmsKeyId   (in der CLI: --kms-key-id) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Amazon KMS-Schlüsselkennung, die bei der Wiederherstellung eines verschlüsselten DB-Clusters aus einem DB-Snapshot oder DB-Cluster-Snapshot verwendet werden soll.

    Die Kennung für den KMS-Schlüssel ist der Amazon-Ressourcenname (ARN) für den KMS-Verschlüsselungsschlüssel. Wenn Sie ein DB-Cluster mit demselben Amazon-Konto wiederherstellen, das über den KMS-Verschlüsselungsschlüssel verfügt, der für die Verschlüsselung des neuen DB-Clusters verwendet wurde, können Sie den KMS-Schlüssel-Alias anstelle des ARNs für den KMS-Verschlüsselungsschlüssel verwenden.

    Wenn Sie keinen Wert für den Parameter KmsKeyId angeben, geschieht folgendes:

    • Wenn der DB-Snapshot oder DB-Cluster-Snapshot in SnapshotIdentifier verschlüsselt ist, wird der wiederhergestellte DB-Cluster anhand des KMS-Schlüssels verschlüsselt, der zum Verschlüsseln des DB-Snapshots oder DB-Cluster-Snapshots verwendet wurde.

    • Wenn der DB-Snapshot oder DB-Cluster Snapshot in SnapshotIdentifier nicht verschlüsselt ist, ist der wiederhergestellte DB-Cluster nicht verschlüsselt.

  • Port  (in der CLI: --port) – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Die Nummer des Ports, an dem der neue DB-Cluster Verbindungen akzeptiert.

    Einschränkungen: Der Wert muss 1150-65535 lauten.

    Standard: Der gleiche Port wie der ursprüngliche DB-Cluster.

  • ServerlessV2ScalingConfiguration  (in der CLI: --serverless-v2-scaling-configuration) – Ein ServerlessV2ScalingConfiguration-Objekt.

    Enthält die Skalierungskonfiguration eines Neptune Serverless DB-Clusters.

    Weitere Informationen finden Sie unter Verwendung von Amazon Neptune Serverless im Amazon Neptune-Benutzerhandbuch.

  • SnapshotIdentifier  (in der CLI: --snapshot-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung für den DB-Snapshot oder den DB-Cluster-Snapshot, der zur Wiederherstellung verwendet werden soll.

    Sie können entweder den Namen oder den Amazon-Ressourcennamen (ARN) verwenden, um einen DB-Cluster-Snapshot festzulegen. Sie können jedoch nur den ARN verwenden, um einen DB-Snapshot festzulegen.

    Einschränkungen:

    • Muss mit der Kennung eines vorhandenen Snapshots übereinstimmen.

  • StorageType   (in der CLI: --storage-type) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Speichertyp an, der dem DB-Cluster zugeordnet werden soll.

    Zulässige Werte: standard, iopt1

    Standard: standard

  • Tags  (in der CLI: --tags) –  Ein Array von Tag Objekten.

    Die Tags, die dem wiederhergestellten DB-Cluster zugewiesen werden sollen.

  • VpcSecurityGroupIds   (in der CLI: --vpc-security-group-ids) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine Liste der VPC-Sicherheitsgruppen, zu denen der neue DB-Cluster gehören wird.

Antwort

Enthält die Details eines Amazon Neptune-DB-Clusters.

Dieser Datentyp wird als Antwortelement in der DescribeDBClusters (Aktion) verwendet.

  • AllocatedStorage – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    AllocatedStorage gibt immer 1 zurück, da die Neptune-DB-Cluster-Speichergröße nicht fest ist, sondern sich bei Bedarf automatisch anpasst.

  • AssociatedRoles – Ein Array mit DBClusterRole-Objekten.

    Bietet eine Liste der Amazon Identity and Access Management (IAM)-Rollen, die dem DB-Cluster zugeordnet sind. IAM-Rollen, die einem DB-Cluster zugeordnet sind, erteilen dem DB-Cluster die Berechtigung, auf andere Amazon-Services in Ihrem Namen zuzugreifen.

  • AutomaticRestartTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Zeitpunkt, zu dem der DB-Cluster automatisch neu gestartet wird.

  • AvailabilityZones   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Liste der EC2 Availability Zones bereit, in denen Instances im DB-Cluster erstellt werden können.

  • BacktrackConsumedChangeRecords – LongOptional-Wert vom Typ long (eine 64-Bit-Ganzzahl mit Vorzeichen).

    Wird von Neptune nicht unterstützt.

  • BacktrackWindow – LongOptional-Wert vom Typ long (eine 64-Bit-Ganzzahl mit Vorzeichen).

    Wird von Neptune nicht unterstützt.

  • BackupRetentionPeriod – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt die Anzahl der Tage an, für die automatische DB-Snapshots aufbewahrt werden.

  • Capacity – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Wird von Neptune nicht unterstützt.

  • CloneGroupId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Identifiziert die Clone-Gruppe, mit der der DB-Cluster verknüpft ist.

  • ClusterCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den Zeitpunkt an, an dem der DB-Cluster erstellt wurde, in UTC (Universal Coordinated Time).

  • CopyTagsToSnapshot – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Wenn auf true gesetzt, werden Tags in jeden Snapshot des DB-Clusters kopiert, der erstellt wird.

  • CrossAccountClone – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Wenn auf true gesetzt, kann der DB-Cluster kontenübergreifend geklont werden.

  • DatabaseName   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Enthält den Namen der initialen Datenbank dieses DB-Clusters, die zum Erstellungszeitpunkt bereitgestellt wurde, sofern eine angegeben wurde, als der DB-Cluster erstellt wurde. Derselbe Name wird über die Lebensdauer des DB-Clusters zurückgegeben.

  • DBClusterArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Amazon-Ressourcenname (ARN) für den DB-Cluster.

  • DBClusterIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Enthält eine vom Benutzer bereitgestellte DB-Cluster-Kennung. Diese Kennung ist der eindeutige Schlüssel zur Identifizierung eines DB-Clusters.

  • DBClusterMembers – Ein Array mit DBClusterMember-Objekten.

    Enthält eine Liste der Instances, aus denen der DB-Cluster besteht.

  • DBClusterParameterGroup   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Namen der DB-Cluster-Parametergruppe für den DB-Cluster an.

  • DbClusterResourceId   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die für die Amazon-Region eindeutige, unveränderliche Kennung für den DB-Cluster. Diese Kennung ist in den Amazon CloudTrail-Protokolleinträgen enthalten, wenn auf den Amazon KMS-Schlüssel für den DB-Cluster zugegriffen wird.

  • DBSubnetGroup   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt Informationen zu der Subnetzgruppe an, die dem DB-Cluster zugeordnet ist, einschließlich dem Namen, der Beschreibung und der Subnetze in der Subnetzgruppe.

  • DeletionProtection – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der Löschschutz des DB-Clusters aktiviert ist. Die Datenbank kann nicht gelöscht werden, wenn der Löschschutz aktiviert ist.

  • EarliestBacktrackTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Wird von Neptune nicht unterstützt.

  • EarliestRestorableTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den frühesten Zeitpunkt an, zu dem eine Datenbank mit zeitbezogener Wiederherstellung wiederhergestellt werden kann.

  • EnabledCloudwatchLogsExports – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine Liste der Protokolltypen, für deren Export zu CloudWatch Logs dieser DB-Cluster konfiguriert ist. Gültige Protokolltypen sind: audit (um Audit-Protokolle in CloudWatch zu veröffentlichen) und slowquery (um slow-query-Protokolle in CloudWatch zu veröffentlichen). Siehe Veröffentlichung von Neptune-Protokollen in Amazon CloudWatch Logs.

  • Endpoint – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Verbindungsendpunkt für die primäre Instance des DB-Clusters an.

  • Engine – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Namen der Datenbank-Engine an, die für diesen DB-Cluster verwendet werden soll.

  • EngineVersion – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt die Version der Datenbank-Engine an.

  • GlobalClusterIdentifier – ein GlobalClusterIdentifier vom Typ string (eine UTF-8-kodierte Zeichenfolge), nicht weniger als 1 oder mehr als 255 ?st?s, entspricht diesem regulären Ausdruck: [A-Za-z][0-9A-Za-z-:._]*.

    Enthält eine vom Benutzer bereitgestellte gelobale Datenbank-Cluster-ID. Diese Kennung ist der eindeutige Schlüssel zur Identifizierung einer globalen Datenbank.

  • HostedZoneId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt die ID an, die Amazon Route 53 zuweist, wenn Sie eine gehostete Zone erstellen.

  • IAMDatabaseAuthenticationEnabled – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Dies ist „true“, wenn die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbank-Konten aktiviert ist. Andernfalls „false“.

  • IOOptimizedNextAllowedModificationTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Beim nächsten Mal können Sie den DB-Cluster so ändern, dass der Speichertyp iopt1 verwendet wird.

  • KmsKeyId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wenn StorageEncrypted „true“ ist, ist dies die Amazon-KMS-Schlüsselkennung für das verschlüsselte DB-Cluster.

  • LatestRestorableTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den spätesten Zeitpunkt an, an dem eine Datenbank mit zeitbezogener Wiederherstellung wiederhergestellt werden kann.

  • MultiAZ – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster über Instances in mehreren Availability Zones verfügt.

  • PendingModifiedValues   – Ein ClusterPendingModifiedValues-Objekt.

    Dieser Datentyp wird als Antwortelement in der ModifyDBCluster Operation verwendet und enthält Änderungen, die während des nächsten Wartungsfensters angewendet werden.

  • PercentProgress – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Fortschritt der Operation als Prozentsatz an.

  • Port – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt die Portnummer an, die von der Datenbank-Engine überwacht wird.

  • PreferredBackupWindow – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den täglichen Zeitraum in koordinierter Weltzeit (UTC) an, in dem automatische Sicherungen erstellt werden, wenn automatische Sicherungen aktiviert sind, gemäß BackupRetentionPeriod.

  • PreferredMaintenanceWindow – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den wöchentlichen Zeitraum, in dem Systemwartungen durchgeführt werden können, in UTC (Universal Coordinated Time) an.

  • ReaderEndpoint – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Leser-Endpunkt für den DB-Cluster. Der Reader-Endpunkt für ein DB-Cluster gleicht die Verbindungslasten zwischen den Read Replicas aus, die in einem DB-Cluster verfügbar sind. Während Clients neue Verbindungsanfragen an den Reader-Endpunkt tätigen, verteilt Neptune die Verbindungsanfragen zwischen den Read Replicas im DB-Cluster. Diese Funktionalität sorgt dafür, dass die Workload-Auslastung für Lesevorgänge auf mehrere Read Replicas im DB-Cluster verteilt wird.

    Wenn ein Failover auftritt und das Read Replica, mit dem Sie verbunden sind, als primäre Instance hochgestuft wird, wird Ihre Verbindung unterbrochen. Verbinden Sie sich erneut mit dem Reader-Endpunkt, um mit dem Senden Ihres Workloads für Lesevorgänge an andere Read Replicas im Cluster fortzufahren.

  • ReadReplicaIdentifiers – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Enthält eine oder mehrere Kennungen der mit diesem DB-Cluster verbundenen Read Replicas.

  • ReplicationSourceIdentifier – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wird von Neptune nicht unterstützt.

  • ReplicationType – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wird von Neptune nicht unterstützt.

  • ServerlessV2ScalingConfiguration   – Ein ServerlessV2ScalingConfigurationInfo-Objekt.

    Zeigt die Skalierungskonfiguration für einen Neptune Serverless DB-Cluster.

    Weitere Informationen finden Sie unter Verwendung von Amazon Neptune Serverless im Amazon Neptune-Benutzerhandbuch.

  • Status – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den aktuellen Status dieses DB-Clusters an.

  • StorageEncrypted – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster verschlüsselt ist.

  • StorageType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Speichertyp, der vom DB-Cluster verwendet wird.

    Zulässige Werte:

    • standard – (Standard) Stellt kostengünstigen Datenbankspeicher für Anwendungen mit mäßiger bis geringer E/A-Nutzung bereit.

    • iopt1 – Aktiviert E/A-optimierten Speicher. Dieser ist darauf ausgelegt, die Anforderungen E/A-intensiver Graph-Workloads zu erfüllen, für die vorhersehbare Kosten, eine geringe E/A-Latenz und ein konstanter E/A-Durchsatz erforderlich sind.

      E/A-optimierter Neptune-Speicher ist erst ab Engine-Version 1.3.0.0 verfügbar.

  • VpcSecurityGroups – Ein Array mit VpcSecurityGroupMembership-Objekten.

    Stellt eine Liste der VPC-Sicherheitsgruppen zur Verfügung, zu denen das DB-Cluster gehört.

Fehler

RestoreDBClusterToPointInTime (Aktion)

        Der AWS CLI-Name für diese API lautet: restore-db-cluster-to-point-in-time.

Stellt einen DB-Cluster im Zustand eines beliebigen Zeitpunkts wieder her. Benutzer können den Zustand jedes beliebigen Zeitpunkts vor LatestRestorableTime bis zu BackupRetentionPeriod Tagen wiederherstellen. Der Ziel-DB-Cluster wird vom Quell-DB-Cluster mit der gleichen Konfiguration wie der ursprüngliche DB-Cluster erstellt, mit der Ausnahme, dass der neue DB-Cluster mit der Standard-DB-Sicherheitsgruppe erstellt wird.

Anmerkung

Diese Aktion stellt nur den DB-Cluster wieder her, nicht die DB-Instances für diesen DB-Cluster. Sie müssen die Aktion CreateDBInstance (Aktion) aufrufen, um DB-Instances für den wiederhergestellten DB-Cluster zu erstellen, wobei Sie in DBClusterIdentifier die Kennung des wiederhergestellten DB-Clusters angeben. Sie können DB-Instances erst erstellen, nachdem die Aktion RestoreDBClusterToPointInTime abgeschlossen ist und der DB-Cluster verfügbar ist.

Anforderung

  • DBClusterIdentifier  (in der CLI: --db-cluster-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name des neuen DB-Clusters, der erstellt werden soll.

    Einschränkungen:

    • Muss zwischen 1 und 63 Buchstaben, Ziffern oder Bindestriche enthalten.

    • Muss mit einem Buchstaben beginnen

    • Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten

  • DBClusterParameterGroupName   (in der CLI: --db-cluster-parameter-group-name) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name der DB-Cluster-Parametergruppe, die mit dem neuen DB-Cluster verknüpft werden soll.

    Einschränkungen:

    • Wenn das Argument angegeben wird, muss der Wert mit dem Namen einer vorhandenen DBClusterParameterGroup übereinstimmen.

  • DBSubnetGroupName   (in der CLI: --db-subnet-group-name) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name der DB-Subnetzgruppe, die für den neuen DB-Cluster verwendet werden soll.

    Einschränkungen: Falls angegeben, muss der Wert mit dem Namen einer vorhandenen DBSubnetGroup übereinstimmen.

    Beispiel: mySubnetgroup

  • DeletionProtection  (in der CLI: --deletion-protection) – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Ein Wert, der angibt, ob der Löschschutz des DB-Clusters aktiviert ist. Die Datenbank kann nicht gelöscht werden, wenn der Löschschutz aktiviert ist. Der Löschschutz ist standardmäßig deaktiviert.

  • EnableCloudwatchLogsExports   (in der CLI: --enable-cloudwatch-logs-exports) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine Liste der Protokolle, die dieser DB-Cluster zu CloudWatch Logs exportieren soll.

  • EnableIAMDatabaseAuthentication  (in der CLI: --enable-iam-database-authentication) – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    „True“, um die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbankkonten zu aktivieren; andernfalls „false“.

    Standard: false

  • KmsKeyId   (in der CLI: --kms-key-id) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Amazon KMS-Schlüsselkennung, die bei der Wiederherstellung eines verschlüsselten DB-Clusters aus einem verschlüsselten DB-Cluster verwendet werden soll.

    Die Kennung für den KMS-Schlüssel ist der Amazon-Ressourcenname (ARN) für den KMS-Verschlüsselungsschlüssel. Wenn Sie ein DB-Cluster mit demselben Amazon-Konto wiederherstellen, das über den KMS-Verschlüsselungsschlüssel verfügt, der für die Verschlüsselung des neuen DB-Clusters verwendet wurde, können Sie den KMS-Schlüssel-Alias anstelle des ARNs für den KMS-Verschlüsselungsschlüssel verwenden.

    Sie können auf einen neuen DB-Cluster wiederherstellen und den neuen DB-Cluster mit einem KMS-Schlüssel verschlüsseln, der sich von dem KMS-Schlüssel unterscheidet, der zum Verschlüsseln des Quell-DB-Clusters verwendet wurde. Der neue DB-Cluster wird mit dem KMS-Schlüssel verschlüsselt, der durch den Parameter KmsKeyId gekennzeichnet ist.

    Wenn Sie keinen Wert für den Parameter KmsKeyId angeben, geschieht folgendes:

    • Wenn der DB-Cluster verschlüsselt ist, dann wird der wiederhergestellte DB-Cluster mit dem KMS-Schlüssel verschlüsselt, mit dem auch der Quell-DB-Cluster verschlüsselt wurde.

    • Wenn der DB-Cluster nicht verschlüsselt ist, dann ist der wiederhergestellte DB-Cluster nicht verschlüsselt.

    Wenn sich DBClusterIdentifier auf einen DB-Cluster bezieht, der nicht verschlüsselt ist, wird die Wiederherstellungsanforderung abgelehnt.

  • Port  (in der CLI: --port) – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Die Nummer des Ports, an dem der neue DB-Cluster Verbindungen akzeptiert.

    Einschränkungen: Der Wert muss 1150-65535 lauten.

    Standard: Der gleiche Port wie der ursprüngliche DB-Cluster.

  • RestoreToTime  (in der CLI: --restore-to-time) –  TStamp-Wert vom Typ timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Das Datum und die Uhrzeit für die Wiederherstellung des DB-Clusters.

    Gültige Werte: Der Wert muss eine Uhrzeit im UTC-Format (Universal Coordinated Time) sein

    Einschränkungen:

    • Muss vor dem letzten wiederherstellbaren Zeitpunkt für die DB-Instance liegen

    • Muss angegeben werden, wenn der Parameter UseLatestRestorableTime nicht angegeben ist

    • Kann nicht angegeben werden, wenn der Parameter UseLatestRestorableTime auf "true" festgelegt ist

    • Kann nicht angegeben werden, wenn der Parameter RestoreType auf copy-on-write festgelegt ist

    Beispiel: 2015-03-07T23:45:00Z

  • RestoreType   (in der CLI: --restore-type) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Typ der auszuführenden Wiederherstellung. Sie können einen der folgenden Werte angeben:

    • full-copy – Der neue DB-Cluster wird als vollständige Kopie des Quell-DB-Clusters wiederhergestellt.

    • copy-on-write – Der neue DB-Cluster wird als Klon des Quell-DB-Clusters wiederhergestellt.

    Wenn Sie keinen Wert für RestoreType angeben, wird der neue DB-Cluster als vollständige Kopie des Quell-DB-Clusters wiederhergestellt.

  • ServerlessV2ScalingConfiguration  (in der CLI: --serverless-v2-scaling-configuration) – Ein ServerlessV2ScalingConfiguration-Objekt.

    Enthält die Skalierungskonfiguration eines Neptune Serverless DB-Clusters.

    Weitere Informationen finden Sie unter Verwendung von Amazon Neptune Serverless im Amazon Neptune-Benutzerhandbuch.

  • SourceDBClusterIdentifier  (in der CLI: --source-db-cluster-identifier) –  Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des Quell-DB-Clusters, von dem wiederhergestellt werden soll.

    Einschränkungen:

    • Muss der Kennung eines vorhandenen DBCluster-Werts entsprechen.

  • StorageType   (in der CLI: --storage-type) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Speichertyp an, der dem DB-Cluster zugeordnet werden soll.

    Zulässige Werte: standard, iopt1

    Standard: standard

  • Tags  (in der CLI: --tags) –  Ein Array von Tag Objekten.

    Die Tags, die auf den wiederhergestellten DB-Cluster angewendet werden sollen.

  • UseLatestRestorableTime  (in der CLI: --use-latest-restorable-time) – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Ein Wert, der auf true festgelegt ist, um den DB-Cluster auf den letzten wiederherstellbaren Sicherungszeitpunkt wiederherzustellen, und sonst false anzeigt.

    Standard: false

    Einschränkungen: Darf nicht angegeben werden, wenn der Parameter RestoreToTime angegeben ist.

  • VpcSecurityGroupIds   (in der CLI: --vpc-security-group-ids) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine Liste der VPC-Sicherheitsgruppen, zu denen der neue DB-Cluster gehört.

Antwort

Enthält die Details eines Amazon Neptune-DB-Clusters.

Dieser Datentyp wird als Antwortelement in der DescribeDBClusters (Aktion) verwendet.

  • AllocatedStorage – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    AllocatedStorage gibt immer 1 zurück, da die Neptune-DB-Cluster-Speichergröße nicht fest ist, sondern sich bei Bedarf automatisch anpasst.

  • AssociatedRoles – Ein Array mit DBClusterRole-Objekten.

    Bietet eine Liste der Amazon Identity and Access Management (IAM)-Rollen, die dem DB-Cluster zugeordnet sind. IAM-Rollen, die einem DB-Cluster zugeordnet sind, erteilen dem DB-Cluster die Berechtigung, auf andere Amazon-Services in Ihrem Namen zuzugreifen.

  • AutomaticRestartTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Zeitpunkt, zu dem der DB-Cluster automatisch neu gestartet wird.

  • AvailabilityZones   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Liste der EC2 Availability Zones bereit, in denen Instances im DB-Cluster erstellt werden können.

  • BacktrackConsumedChangeRecords – LongOptional-Wert vom Typ long (eine 64-Bit-Ganzzahl mit Vorzeichen).

    Wird von Neptune nicht unterstützt.

  • BacktrackWindow – LongOptional-Wert vom Typ long (eine 64-Bit-Ganzzahl mit Vorzeichen).

    Wird von Neptune nicht unterstützt.

  • BackupRetentionPeriod – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt die Anzahl der Tage an, für die automatische DB-Snapshots aufbewahrt werden.

  • Capacity – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Wird von Neptune nicht unterstützt.

  • CloneGroupId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Identifiziert die Clone-Gruppe, mit der der DB-Cluster verknüpft ist.

  • ClusterCreateTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den Zeitpunkt an, an dem der DB-Cluster erstellt wurde, in UTC (Universal Coordinated Time).

  • CopyTagsToSnapshot – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Wenn auf true gesetzt, werden Tags in jeden Snapshot des DB-Clusters kopiert, der erstellt wird.

  • CrossAccountClone – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Wenn auf true gesetzt, kann der DB-Cluster kontenübergreifend geklont werden.

  • DatabaseName   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Enthält den Namen der initialen Datenbank dieses DB-Clusters, die zum Erstellungszeitpunkt bereitgestellt wurde, sofern eine angegeben wurde, als der DB-Cluster erstellt wurde. Derselbe Name wird über die Lebensdauer des DB-Clusters zurückgegeben.

  • DBClusterArn   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Amazon-Ressourcenname (ARN) für den DB-Cluster.

  • DBClusterIdentifier   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Enthält eine vom Benutzer bereitgestellte DB-Cluster-Kennung. Diese Kennung ist der eindeutige Schlüssel zur Identifizierung eines DB-Clusters.

  • DBClusterMembers – Ein Array mit DBClusterMember-Objekten.

    Enthält eine Liste der Instances, aus denen der DB-Cluster besteht.

  • DBClusterParameterGroup   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Namen der DB-Cluster-Parametergruppe für den DB-Cluster an.

  • DbClusterResourceId   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die für die Amazon-Region eindeutige, unveränderliche Kennung für den DB-Cluster. Diese Kennung ist in den Amazon CloudTrail-Protokolleinträgen enthalten, wenn auf den Amazon KMS-Schlüssel für den DB-Cluster zugegriffen wird.

  • DBSubnetGroup   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt Informationen zu der Subnetzgruppe an, die dem DB-Cluster zugeordnet ist, einschließlich dem Namen, der Beschreibung und der Subnetze in der Subnetzgruppe.

  • DeletionProtection – BooleanOptional-Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der Löschschutz des DB-Clusters aktiviert ist. Die Datenbank kann nicht gelöscht werden, wenn der Löschschutz aktiviert ist.

  • EarliestBacktrackTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Wird von Neptune nicht unterstützt.

  • EarliestRestorableTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den frühesten Zeitpunkt an, zu dem eine Datenbank mit zeitbezogener Wiederherstellung wiederhergestellt werden kann.

  • EnabledCloudwatchLogsExports – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine Liste der Protokolltypen, für deren Export zu CloudWatch Logs dieser DB-Cluster konfiguriert ist. Gültige Protokolltypen sind: audit (um Audit-Protokolle in CloudWatch zu veröffentlichen) und slowquery (um slow-query-Protokolle in CloudWatch zu veröffentlichen). Siehe Veröffentlichung von Neptune-Protokollen in Amazon CloudWatch Logs.

  • Endpoint – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Verbindungsendpunkt für die primäre Instance des DB-Clusters an.

  • Engine – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Namen der Datenbank-Engine an, die für diesen DB-Cluster verwendet werden soll.

  • EngineVersion – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt die Version der Datenbank-Engine an.

  • GlobalClusterIdentifier – ein GlobalClusterIdentifier vom Typ string (eine UTF-8-kodierte Zeichenfolge), nicht weniger als 1 oder mehr als 255 ?st?s, entspricht diesem regulären Ausdruck: [A-Za-z][0-9A-Za-z-:._]*.

    Enthält eine vom Benutzer bereitgestellte gelobale Datenbank-Cluster-ID. Diese Kennung ist der eindeutige Schlüssel zur Identifizierung einer globalen Datenbank.

  • HostedZoneId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt die ID an, die Amazon Route 53 zuweist, wenn Sie eine gehostete Zone erstellen.

  • IAMDatabaseAuthenticationEnabled – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Dies ist „true“, wenn die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbank-Konten aktiviert ist. Andernfalls „false“.

  • IOOptimizedNextAllowedModificationTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Beim nächsten Mal können Sie den DB-Cluster so ändern, dass der Speichertyp iopt1 verwendet wird.

  • KmsKeyId – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wenn StorageEncrypted „true“ ist, ist dies die Amazon-KMS-Schlüsselkennung für das verschlüsselte DB-Cluster.

  • LatestRestorableTime – ein TStamp vom Typ: timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den spätesten Zeitpunkt an, an dem eine Datenbank mit zeitbezogener Wiederherstellung wiederhergestellt werden kann.

  • MultiAZ – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster über Instances in mehreren Availability Zones verfügt.

  • PendingModifiedValues   – Ein ClusterPendingModifiedValues-Objekt.

    Dieser Datentyp wird als Antwortelement in der ModifyDBCluster Operation verwendet und enthält Änderungen, die während des nächsten Wartungsfensters angewendet werden.

  • PercentProgress – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den Fortschritt der Operation als Prozentsatz an.

  • Port – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt die Portnummer an, die von der Datenbank-Engine überwacht wird.

  • PreferredBackupWindow – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den täglichen Zeitraum in koordinierter Weltzeit (UTC) an, in dem automatische Sicherungen erstellt werden, wenn automatische Sicherungen aktiviert sind, gemäß BackupRetentionPeriod.

  • PreferredMaintenanceWindow – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den wöchentlichen Zeitraum, in dem Systemwartungen durchgeführt werden können, in UTC (Universal Coordinated Time) an.

  • ReaderEndpoint – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Leser-Endpunkt für den DB-Cluster. Der Reader-Endpunkt für ein DB-Cluster gleicht die Verbindungslasten zwischen den Read Replicas aus, die in einem DB-Cluster verfügbar sind. Während Clients neue Verbindungsanfragen an den Reader-Endpunkt tätigen, verteilt Neptune die Verbindungsanfragen zwischen den Read Replicas im DB-Cluster. Diese Funktionalität sorgt dafür, dass die Workload-Auslastung für Lesevorgänge auf mehrere Read Replicas im DB-Cluster verteilt wird.

    Wenn ein Failover auftritt und das Read Replica, mit dem Sie verbunden sind, als primäre Instance hochgestuft wird, wird Ihre Verbindung unterbrochen. Verbinden Sie sich erneut mit dem Reader-Endpunkt, um mit dem Senden Ihres Workloads für Lesevorgänge an andere Read Replicas im Cluster fortzufahren.

  • ReadReplicaIdentifiers – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Enthält eine oder mehrere Kennungen der mit diesem DB-Cluster verbundenen Read Replicas.

  • ReplicationSourceIdentifier – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wird von Neptune nicht unterstützt.

  • ReplicationType – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wird von Neptune nicht unterstützt.

  • ServerlessV2ScalingConfiguration   – Ein ServerlessV2ScalingConfigurationInfo-Objekt.

    Zeigt die Skalierungskonfiguration für einen Neptune Serverless DB-Cluster.

    Weitere Informationen finden Sie unter Verwendung von Amazon Neptune Serverless im Amazon Neptune-Benutzerhandbuch.

  • Status – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Gibt den aktuellen Status dieses DB-Clusters an.

  • StorageEncrypted – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster verschlüsselt ist.

  • StorageType   – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Speichertyp, der vom DB-Cluster verwendet wird.

    Zulässige Werte:

    • standard – (Standard) Stellt kostengünstigen Datenbankspeicher für Anwendungen mit mäßiger bis geringer E/A-Nutzung bereit.

    • iopt1 – Aktiviert E/A-optimierten Speicher. Dieser ist darauf ausgelegt, die Anforderungen E/A-intensiver Graph-Workloads zu erfüllen, für die vorhersehbare Kosten, eine geringe E/A-Latenz und ein konstanter E/A-Durchsatz erforderlich sind.

      E/A-optimierter Neptune-Speicher ist erst ab Engine-Version 1.3.0.0 verfügbar.

  • VpcSecurityGroups – Ein Array mit VpcSecurityGroupMembership-Objekten.

    Stellt eine Liste der VPC-Sicherheitsgruppen zur Verfügung, zu denen das DB-Cluster gehört.

Fehler

DescribeDBClusterSnapshots (Aktion)

        Der AWS CLI-Name für diese API lautet: describe-db-cluster-snapshots.

Gibt Informationen zu DB-Cluster-Snapshots zurück. Diese API-Aktion unterstützt Paginierung.

Anforderung

  • DBClusterIdentifier  (in der CLI: --db-cluster-identifier) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die ID des DB-Clusters, für den die Liste von DB-Cluster-Snapshots abgerufen werden soll. Dieser Parameter kann nicht in Verbindung mit dem Parameter DBClusterSnapshotIdentifier verwendet werden. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

    Einschränkungen:

    • Falls angegeben, muss er mit der Kennung eines vorhandenen DBCluster übereinstimmen.

  • DBClusterSnapshotIdentifier   (in der CLI: --db-cluster-snapshot-identifier) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Eine bestimmte zu beschreibende DB-Cluster-Snapshot-Kennung. Dieser Parameter kann nicht in Verbindung mit dem Parameter DBClusterIdentifier verwendet werden. Dieser Wert wird als Zeichenfolge in Kleinbuchstaben gespeichert.

    Einschränkungen:

    • Falls angegeben, muss er mit der Kennung eines vorhandenen DBClusterSnapshot übereinstimmen.

    • Wenn diese Kennung für einen automatisierten Snapshot ist, muss auch der Parameter SnapshotType angegeben werden.

  • Filters  (in der CLI: --filters) –  Ein Array von Filter Objekten.

    Dieser Parameter wird derzeit nicht unterstützt.

  • IncludePublic  (in der CLI: --include-public) – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    „True“, um manuelle DB-Cluster-Snapshots einzuschließen, die öffentlich sind und von jedem beliebigen Amazon-Konto kopiert oder wiederhergestellt werden können, und andernfalls „false“. Der Standardwert ist false. Der Standardwert lautet „false“.

    Sie können mithilfe der API-Aktion ModifyDBClusterSnapshotAttribute (Aktion) einen manuellen DB-Cluster-Snapshot als öffentlich freigeben.

  • IncludeShared  (in der CLI: --include-shared) – boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    „True“, um freigegebene manuelle DB-Cluster-Snapshots von anderen Amazon-Konten einzuschließen, für die diesem Amazon-Konto die Berechtigung zum Kopieren oder Wiederherstellen erteilt wurde, und andernfalls „false“. Der Standardwert ist false.

    Sie können mit der API-Aktion ModifyDBClusterSnapshotAttribute (Aktion) einem Amazon-Konto die Berechtigung zum Wiederherstellen eines manuellen DB-Cluster-Snapshots aus einem anderen Amazon-Konto erteilen.

  • Marker  (in der CLI: --marker) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Ein optionales Paginierungstoken, das von einer vorherigen DescribeDBClusterSnapshots-Anforderung bereitgestellt wird. Wenn Sie diesen Parameter angeben, enthält die Antwort nur die Datensätze zwischen der Markierung und dem durch MaxRecords angegebenen Wert.

  • MaxRecords  (in der CLI: --max-records) – IntegerOptional-Wert vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Die maximale Anzahl der in der Antwort zurückgegebenen Datensätze. Wenn mehrere Datensätze vorhanden sind, als der Wert MaxRecords angibt, ist ein Paginierungstoken mit dem Namen einer Markierung in der Antwort enthalten, sodass die verbleibenden Ergebnisse abgerufen werden können.

    Standard: 100

    Einschränkungen: Mindestwert 20, Höchstwert 100.

  • SnapshotType  (in der CLI: --snapshot-type) – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Typ der DB-Cluster-Snapshots, der zurückgegeben werden soll. Sie können einen der folgenden Werte angeben:

    • automated – Rückgabe aller DB-Cluster-Snapshots, die von Amazon Neptune automatisch für mein Amazon-Konto verwendet wurden.

    • manual – Rückgabe aller DB-Cluster-Snapshots, die von meinem Amazon-Konto verwendet wurden.

    • shared – Rückgabe aller manuellen DB-Cluster-Snapshots, die mit meinem Amazon-Konto geteilt wurden.

    • public – Rückgabe aller DB-Cluster-Snapshots, die als öffentlich markiert wurden.

    Wenn Sie keinen Wert für SnapshotType angeben, werden sowohl automatisierte als auch manuelle DB-Cluster-Snapshots zurückgegeben. Sie können freigegebene DB-Cluster-Snapshots zu diesen Ergebnissen hinzufügen, indem Sie den Parameter IncludeShared auf true festlegen. Sie können öffentliche DB-Cluster-Snapshots zu diesen Ergebnissen hinzufügen, indem Sie den Parameter IncludePublic auf true festlegen.

    Die Parameter IncludePublic und IncludeShared gelten nicht für SnapshotType-Werte von manual oder automated. Der Parameter IncludePublic gilt nicht, wenn SnapshotType auf shared festgelegt ist. Der Parameter IncludeShared gilt nicht, wenn SnapshotType auf public festgelegt ist.

Antwort

  • DBClusterSnapshots – Ein Array mit DBClusterSnapshot-Objekten.

    Stellt eine Liste von DB-Cluster-Snapshots für den Benutzer bereit.

  • Marker – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Ein optionales Paginierungstoken, das von einer vorherigen DescribeDBClusterSnapshots (Aktion)-Anforderung bereitgestellt wird. Wenn Sie diesen Parameter angeben, enthält die Antwort nur die Datensätze zwischen der Markierung und dem durch MaxRecords angegebenen Wert.

Fehler

DescribeDBClusterSnapshotAttributes (Aktion)

        Der AWS CLI-Name für diese API lautet: describe-db-cluster-snapshot-attributes.

Gibt eine Liste der Namen und Werte von DB-Cluster-Attributen eines manuellen DB-Cluster-Snapshots zurück.

Beim Freigeben von Snapshots für andere Amazon-Konten gibt DescribeDBClusterSnapshotAttributes das Attribut restore und eine Liste der IDs für die Amazon-Konten zurück, die zum Kopieren oder Wiederherstellen des manuellen DB-Cluster-Snapshots autorisiert sind. Wenn all in der Liste der Werte für das Attribut restore enthalten ist, dann ist der manuelle DB-Cluster-Snapshot öffentlich und kann von allen Amazon-Konten kopiert oder wiederhergestellt werden.

Um einem Amazon-Konto den Zugriff für das Kopieren oder Wiederherstellen eines manuellen DB-Cluster-Snapshots zu erteilen oder ihn von ihm zu entfernen, oder um einen manuellen DB-Cluster-Snapshot öffentlich oder privat zu machen, verwenden Sie die API-Aktion ModifyDBClusterSnapshotAttribute (Aktion).

Anforderung

  • DBClusterSnapshotIdentifier  (in der CLI: --db-cluster-snapshot-identifier) – Erforderlich: eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung für den DB-Cluster-Snapshot, für den die Attribute beschrieben werden sollen.

Antwort

Enthält die Ergebnisse eines erfolgreichen Aufrufs an die API-Aktion DescribeDBClusterSnapshotAttributes (Aktion).

Manuelle DB-Cluster-Snapshot-Attribute werden verwendet, um andere Amazon-Konten zu autorisieren und einen manuellen DB-Cluster-Snapshot zu kopieren oder wiederherzustellen. Weitere Informationen finden Sie in der API-Aktion ModifyDBClusterSnapshotAttribute (Aktion).

  • DBClusterSnapshotAttributes – Ein Array mit DBClusterSnapshotAttribute-Objekten.

    Die Liste der Attribute und Werte für den manuellen DB-Cluster-Snapshot.

  • DBClusterSnapshotIdentifier – eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des manuellen DB-Cluster-Snapshots, für den die Attribute gelten.

Fehler

Strukturen:

DBClusterSnapshot (Struktur)

Enthält die Details für einen Amazon Neptune-DB-Cluster-Snapshot.

Dieser Datentyp wird als Antwortelement in der Aktion DescribeDBClusterSnapshots (Aktion) verwendet.

Felder

  • AllocatedStorage – Dies ist eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Legt die Größe des zugewiesenen Speichers in Gibibyte (GiB) fest.

  • AvailabilityZones – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Liste der EC2-Availability Zones bereit, in denen Instances im DB-Cluster-Snapshot wiederhergestellt werden können.

  • ClusterCreateTime – ein TStamp vom Typ timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt den Zeitpunkt an, an dem der DB-Cluster erstellt wurde, in UTC (Universal Coordinated Time).

  • DBClusterIdentifier – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die DB-Cluster-Kennung des DB-Clusters fest, anhand dessen dieser DB-Cluster-Snapshot erstellt wurde.

  • DBClusterSnapshotArn – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Amazon-Ressourcenname (ARN) für den DB-Cluster-Snapshot.

  • DBClusterSnapshotIdentifier – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt die Kennung für den DB-Cluster-Snapshot fest. Muss mit der Kennung eines vorhandenen Snapshots übereinstimmen.

    Nachdem Sie einen DB-Cluster mit einem DBClusterSnapshotIdentifier wiederhergestellt haben, müssen Sie denselben DBClusterSnapshotIdentifier für zukünftige Aktualisierungen des DB-Clusters angeben. Wenn Sie diese Eigenschaft für eine Aktualisierung angeben, wird der DB-Cluster nicht erneut aus dem Snapshot wiederhergestellt und die Daten in der Datenbank werden nicht geändert.

    Sollten Sie die DBClusterSnapshotIdentifier-Eigenschaft jedoch nicht angeben, wird ein leerer DB-Cluster erstellt und der ursprüngliche DB-Cluster wird gelöscht. Wenn Sie eine Eigenschaft angeben, die sich von der vorherigen Snapshot-Eigenschaft zur Wiederherstellung unterscheidet, wird der DB-Cluster aus dem Snapshot wiederhergestellt, der durch den DBClusterSnapshotIdentifier angegeben wurde, und der ursprüngliche DB-Cluster gelöscht.

  • Engine – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Namen der Datenbank-Engine fest.

  • EngineVersion – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Version der Datenbank-Engine für diesen DB-Cluster-Snapshot bereit.

  • IAMDatabaseAuthenticationEnabled – Dies ist ein boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Dies ist „true“, wenn die Zuweisung von Amazon Identity and Access Management (IAM)-Konten zu Datenbank-Konten aktiviert ist. Andernfalls „false“.

  • KmsKeyId – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Wenn StorageEncrypted „true“ ist, ist dies die Amazon-KMS-Schlüsselkennung für den verschlüsselten DB-Cluster-Snapshot.

  • LicenseModel – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die Lizenzmodellinformationen für diesen DB-Cluster-Snapshot bereit.

  • PercentProgress – Dies ist eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt einen Prozentsatz der Daten an, die laut Schätzung bereits übertragen wurden.

  • Port – Dies ist eine Ganzzahl vom Typ integer (32-Bit-Ganzzahl mit Vorzeichen).

    Gibt den Port an, den der DB-Cluster zum Zeitpunkt des Snapshots überwacht hat.

  • SnapshotCreateTime – ein TStamp vom Typ timestamp (ein Zeitpunkt, allgemein definiert als Offset von Mitternacht 01.01.1970).

    Gibt das Datum und die Uhrzeit der Erstellung des Snapshots in koordinierter Weltzeit (UTC) an.

  • SnapshotType – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt den Typ des DB-Cluster-Snapshots bereit.

  • SourceDBClusterSnapshotArn – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Falls der DB-Cluster-Snapshot von einem Quell-DB-Cluster-Snapshot kopiert wurde, der Amazon-Ressourcenname (ARN) für den Quell-DB-Cluster-Snapshot, andernfalls ein Null-Wert.

  • Status – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Legt den Status dieses DB-Cluster-Snapshots fest.

  • StorageEncrypted – Dies ist ein boolescher Wert vom Typ boolean (boolescher Wert (wahr oder falsch)).

    Gibt an, ob der DB-Cluster-Snapshot verschlüsselt ist.

  • StorageType – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Speichertyp, der dem DB-Cluster-Snapshot zugeordnet ist.

  • VpcId – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Stellt die VPC-ID bereit, die dem DB-Cluster-Snapshot zugeordnet ist.

DBClusterSnapshot wird als Antwortelement verwendet für:

DBClusterSnapshotAttribute (Struktur)

Enthält die Namen und die Werte eines manuellen DB-Cluster-Snapshot-Attributs.

Manuelle DB-Cluster-Snapshot-Attribute werden verwendet, um andere Amazon-Konten zu autorisieren und einen manuellen DB-Cluster-Snapshot wiederherzustellen. Weitere Informationen finden Sie in der API-Aktion ModifyDBClusterSnapshotAttribute (Aktion).

Felder

  • AttributeName – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der Name des manuellen DB-Cluster-Snapshot-Attributs.

    Das Attribut mit dem Namen restore bezieht sich auf die Liste der Amazon-Konten, die über die Berechtigung zum Kopieren oder Wiederherstellen des manuellen DB-Cluster-Snapshots verfügen. Weitere Informationen finden Sie in der API-Aktion ModifyDBClusterSnapshotAttribute (Aktion).

  • AttributeValues – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Der bzw. die Werte für das manuelle DB-Cluster-Snapshot-Attribut.

    Wenn das Feld AttributeName auf restore festgelegt ist, gibt dieses Element eine Liste der IDs aller Amazon-Konten wieder, die zum Kopieren oder Wiederherstellen des manuellen DB-Cluster-Snapshots autorisiert sind. Wenn sich in der Liste der Wert all befindet, ist der manuelle DB-Cluster-Snapshot öffentlich und für jedes Amazon-Konto zum Kopieren oder Wiederherstellen verfügbar.

DBClusterSnapshotAttributesResult (Struktur)

Enthält die Ergebnisse eines erfolgreichen Aufrufs an die API-Aktion DescribeDBClusterSnapshotAttributes (Aktion).

Manuelle DB-Cluster-Snapshot-Attribute werden verwendet, um andere Amazon-Konten zu autorisieren und einen manuellen DB-Cluster-Snapshot zu kopieren oder wiederherzustellen. Weitere Informationen finden Sie in der API-Aktion ModifyDBClusterSnapshotAttribute (Aktion).

Felder

  • DBClusterSnapshotAttributes – Dies ist ein Array von DBClusterSnapshotAttribute-Objekten.

    Die Liste der Attribute und Werte für den manuellen DB-Cluster-Snapshot.

  • DBClusterSnapshotIdentifier – Dies ist eine Zeichenfolge vom Typ string (UTF-8-kodierte Zeichenfolge).

    Die Kennung des manuellen DB-Cluster-Snapshots, für den die Attribute gelten.

DBClusterSnapshotAttributesResult wird als Antwortelement verwendet für: