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.
CreateDBInstance
Erzeugt eine neue Instanz.
Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.
- DBClusterIdentifier
-
Die ID des Clusters, zu dem die Instance gehört.
Typ: Zeichenfolge
Erforderlich: Ja
- DBInstanceClass
-
Die Rechen- und Speicherkapazität der Instance, beispielsweise
db.r5.large.Typ: Zeichenfolge
Erforderlich: Ja
- DBInstanceIdentifier
-
Die Instance-ID. Dieser Parameter wird als Zeichenfolge in Kleinbuchstaben gespeichert.
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:
mydbinstanceTyp: Zeichenfolge
Erforderlich: Ja
-
- Engine
-
Der Name der Datenbank-Engine, die für diese Instance verwendet werden soll.
Zulässiger Wert:
docdbTyp: Zeichenfolge
Erforderlich: Ja
- AutoMinorVersionUpgrade
-
Dieser Parameter gilt nicht für Amazon DocumentDB. Amazon DocumentDB führt unabhängig vom eingestellten Wert keine kleineren Versions-Upgrades durch.
Standard:
falseTyp: Boolesch
Erforderlich: Nein
- AvailabilityZone
-
Die Amazon EC2-Availability-Zone, in der die Instance erstellt wird.
Standard: Eine zufällige, vom System gewählte Availability Zone auf dem Endpunkt. AWS-Region
Beispiel:
us-east-1dTyp: Zeichenfolge
Erforderlich: Nein
- CACertificateIdentifier
-
Die CA-Zertifikatskennung, die für das Serverzertifikat der DB-Instance verwendet werden soll.
Weitere Informationen finden Sie unter Aktualisieren Ihrer Amazon DocumentDB-TLS-Zertifikate und Verschlüsseln von Daten bei der Übertragung im Amazon DocumentDB-Entwicklerhandbuch.
Typ: Zeichenfolge
Erforderlich: Nein
- CopyTagsToSnapshot
-
Ein Wert, der angibt, ob Tags aus der DB-Instance in Snapshots der DB-Instance kopiert werden sollen. Standardmäßig werden Tags nicht kopiert.
Typ: Boolesch
Erforderlich: Nein
- EnablePerformanceInsights
-
Ein Wert, der angibt, ob Performance Insights für die DB-Instance aktiviert werden sollen. Weitere Informationen finden Sie unter Verwenden von Amazon Performance Insights.
Typ: Boolesch
Erforderlich: Nein
- PerformanceInsightsKMSKeyId
-
Die AWS KMS Schlüssel-ID für die Verschlüsselung von Performance Insights Insights-Daten.
Die AWS KMS Schlüssel-ID ist der Schlüssel-ARN, die Schlüssel-ID, der Alias-ARN oder der Aliasname für den KMS-Schlüssel.
Wenn Sie keinen Wert für PerformanceInsights KMS angebenKeyId, verwendet Amazon DocumentDB Ihren Standard-KMS-Schlüssel. Es gibt einen Standard-KMS-Schlüssel für Ihr Amazon Web Services Services-Konto. Ihr Amazon Web Services Services-Konto hat für jede Amazon Web Services Services-Region einen anderen Standard-KMS-Schlüssel.
Typ: Zeichenfolge
Erforderlich: Nein
- PreferredMaintenanceWindow
-
Der wöchentliche Zeitraum, in dem Systemwartungen durchgeführt werden können, in UTC (Universal Coordinated Time).
Format:
ddd:hh24:mi-ddd:hh24:miDie Standardeinstellung ist ein 30-minütiges Fenster, das nach dem Zufallsprinzip aus einem 8-Stunden-Zeitblock ausgewählt wird und an einem zufälligen Wochentag stattfindet. AWS-Region
Gültige Tage: Mo, Di, Mi, Do, Fr, Sa, So
Einschränkungen: mindestens 30-Minuten-Zeitfenster.
Typ: Zeichenfolge
Erforderlich: Nein
- PromotionTier
-
Ein Wert, der die Reihenfolge angibt, in der ein Amazon DocumentDB DocumentDB-Replikat nach einem Ausfall der vorhandenen primären Instance zur primären Instance heraufgestuft wird.
Standard: 1
Gültige Werte: 0-15
Typ: Ganzzahl
Erforderlich: Nein
- Stichworte.Tag.N
-
Die Tags, die der Instance zugewiesen werden sollen. Sie können einer Instance bis zu 10 Tags zuweisen.
Typ: Array von Tag-Objekten
Erforderlich: Nein
Antwortelemente
Das folgende Element wird vom Dienst zurückgegeben.
- DBInstance
-
Detaillierte Informationen zu einer Instanz.
Typ: DBInstance Objekt
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- AuthorizationNotFound
-
Die angegebene CIDR-IP oder Amazon EC2-Sicherheitsgruppe ist für die angegebene Sicherheitsgruppe nicht autorisiert.
Amazon DocumentDB ist möglicherweise auch nicht autorisiert, die erforderlichen Aktionen in Ihrem Namen mithilfe von IAM durchzuführen.
HTTP Status Code: 404
- DBClusterNotFoundFault
-
DBClusterIdentifierbezieht sich nicht auf einen vorhandenen Cluster.HTTP Status Code: 404
- DBInstanceAlreadyExists
-
Sie haben bereits eine Instanz mit der angegebenen ID.
HTTP Status Code: 400
- DBParameterGroupNotFound
-
DBParameterGroupNamebezieht sich nicht auf eine bestehende Parametergruppe.HTTP Status Code: 404
- DBSecurityGroupNotFound
-
DBSecurityGroupNamebezieht sich nicht auf eine bestehende Sicherheitsgruppe.HTTP Status Code: 404
- DBSubnetGroupDoesNotCoverEnoughAZs
-
Subnetze in der Subnetzgruppe sollten mindestens zwei Availability Zones abdecken, es sei denn, es gibt nur eine Availability Zone.
HTTP Status Code: 400
- DBSubnetGroupNotFoundFault
-
DBSubnetGroupNamebezieht sich nicht auf eine bestehende Subnetzgruppe.HTTP Status Code: 404
- InstanceQuotaExceeded
-
Die Anfrage würde dazu führen, dass Sie die zulässige Anzahl von Instanzen überschreiten.
HTTP Status Code: 400
- InsufficientDBInstanceCapacity
-
Die angegebene Instanzklasse ist in der angegebenen Availability Zone nicht verfügbar.
HTTP Status Code: 400
- InvalidDBClusterStateFault
-
Der Cluster befindet sich nicht in einem gültigen Zustand.
HTTP Status Code: 400
- InvalidSubnet
-
Das angeforderte Subnetz ist ungültig, oder es wurden mehrere Subnetze angefordert, die sich nicht alle in einer gemeinsamen Virtual Private Cloud (VPC) befinden.
HTTP Status Code: 400
- InvalidVPCNetworkStateFault
-
Die Subnetzgruppe deckt nach ihrer Erstellung nicht alle Availability Zones ab, da Änderungen vorgenommen wurden.
HTTP Status Code: 400
- KMSKeyNotAccessibleFault
-
Beim Zugriff auf einen AWS KMS Schlüssel ist ein Fehler aufgetreten.
HTTP Status Code: 400
- StorageQuotaExceeded
-
Die Anfrage würde dazu führen, dass Sie die zulässige Menge an Speicherplatz überschreiten, die für alle Instanzen verfügbar ist.
HTTP Status Code: 400
- StorageTypeNotSupported
-
Der angegebene Speicher
StorageTypekann der DB-Instance nicht zugeordnet werden.HTTP Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden:
