Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
RestoreDBClusterFromSnapshot
Crea un nuovo cluster da un'istantanea o da un'istantanea del cluster.
Se viene specificata un'istantanea, il cluster di destinazione viene creato dallo snapshot del DB di origine con una configurazione e un gruppo di sicurezza predefiniti.
Se viene specificata un'istantanea del cluster, il cluster di destinazione viene creato dal punto di ripristino del cluster di origine con la stessa configurazione del cluster DB di origine, tranne per il fatto che il nuovo cluster viene creato con il gruppo di sicurezza predefinito.
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
- DBClusterIdentifier
-
Il nome del cluster da creare a partire dall'istantanea o dall'istantanea del cluster. Questo parametro non fa distinzione tra maiuscole e minuscole.
Vincoli:
-
Deve contenere da 1 a 63 lettere, numeri o trattini.
-
Il primo carattere deve essere una lettera.
-
Non può terminare con un trattino o contenere due trattini consecutivi.
Esempio:
my-snapshot-id
Tipo: stringa
Campo obbligatorio: sì
-
- Engine
-
Il motore di database da utilizzare per il nuovo cluster.
Predefinito: lo stesso del codice sorgente.
Vincolo: deve essere compatibile con il motore del sorgente.
Tipo: stringa
Campo obbligatorio: sì
- SnapshotIdentifier
-
L'identificatore dello snapshot o dello snapshot del cluster da cui effettuare il ripristino.
È possibile utilizzare il nome o l'Amazon Resource Name (ARN) per specificare uno snapshot del cluster. Tuttavia, è possibile utilizzare solo l'ARN per specificare uno snapshot.
Vincoli:
-
Deve corrispondere all'identificatore di una snapshot esistente.
Tipo: stringa
Campo obbligatorio: sì
-
- AvailabilityZones. AvailabilityZoneN.
-
Fornisce l'elenco delle zone di disponibilità di Amazon EC2 in cui è possibile creare le istanze nel cluster DB ripristinato.
Tipo: matrice di stringhe
Campo obbligatorio: no
- DBClusterParameterGroupName
-
Nome del gruppo di parametri del cluster di database che desideri associare al cluster di database.
Tipo: stringa. Obbligatorio: No.
Se questo argomento viene omesso, viene utilizzato il gruppo di parametri predefinito del cluster DB. Se fornito, deve corrispondere al nome di un gruppo di parametri predefinito del cluster DB esistente. La stringa deve essere composta da 1 a 255 lettere, numeri o trattini. Il primo carattere deve essere una lettera e non può terminare con un trattino o contenere due trattini consecutivi.
▬Tipo: stringa
Campo obbligatorio: no
- DBSubnetGroupName
-
Il nome del gruppo di sottoreti da utilizzare per il nuovo cluster.
Vincoli: se forniti, devono corrispondere al nome di un esistente.
DBSubnetGroup
Esempio:
mySubnetgroup
▬Tipo: stringa
Campo obbligatorio: no
- DeletionProtection
-
Speciifica se questo cluster può essere eliminato. Se
DeletionProtection
è abilitato, il cluster non può essere eliminato a meno che non venga modificato eDeletionProtection
disabilitato.DeletionProtection
protegge i cluster dall'eliminazione accidentale.Tipo: Booleano
Campo obbligatorio: no
- EnableCloudwatchLogsExports.membro.
-
Un elenco di tipi di log che devono essere abilitati per l'esportazione in Amazon CloudWatch Logs.
Tipo: matrice di stringhe
Campo obbligatorio: no
- EngineVersion
-
La versione del motore di database da utilizzare per il nuovo cluster.
▬Tipo: stringa
Campo obbligatorio: no
- KmsKeyId
-
L'identificatore AWS KMS chiave da utilizzare per il ripristino di un cluster crittografato da un'istantanea del database o da un'istantanea del cluster.
L'identificatore della AWS KMS chiave è Amazon Resource Name (ARN) per AWS KMS la chiave di crittografia. Se si ripristina un cluster con Account AWS lo stesso proprietario della chiave di AWS KMS crittografia utilizzata per crittografare il nuovo cluster, è possibile utilizzare l'alias della AWS KMS chiave anziché l'ARN per la chiave di crittografia. AWS KMS
Se non specifichi un valore per il parametro
KmsKeyId
, avviene quanto segue:-
Se l'istantanea o l'istantanea del cluster in
SnapshotIdentifier
è crittografata, il cluster ripristinato viene crittografato utilizzando la AWS KMS chiave utilizzata per crittografare l'istantanea o l'istantanea del cluster. -
Se l'istantanea o l'istantanea del cluster in ingresso non
SnapshotIdentifier
è crittografata, il cluster DB ripristinato non è crittografato.
▬Tipo: stringa
Campo obbligatorio: no
-
- Port
-
Il numero di porta su cui il nuovo cluster accetta le connessioni.
Vincoli: deve essere un valore compreso tra a
1150
.65535
Impostazione predefinita: la stessa porta del cluster originale.
Tipo: integer
Campo obbligatorio: no
- StorageType
-
Il tipo di archiviazione da associare al cluster di database.
Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.
Valori validi per il tipo di storage -
standard | iopt1
Il valore predefinito è
standard
▬Tipo: stringa
Campo obbligatorio: no
- Tags.Tag.N
-
I tag da assegnare al cluster ripristinato.
Tipo: matrice di oggetti Tag
Campo obbligatorio: no
- VpcSecurityGroupIds. VpcSecurityGroupIdN.
-
Un elenco di gruppi di sicurezza del cloud privato virtuale (VPC) a cui apparterrà il nuovo cluster.
Tipo: matrice di stringhe
Campo obbligatorio: no
Elementi di risposta
Il servizio restituisce il seguente elemento.
- DBCluster
-
Informazioni dettagliate su un cluster.
Tipo: oggetto DBCluster
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- DBClusterAlreadyExistsFault
-
Hai già un cluster con l'identificatore fornito.
Codice di stato HTTP: 400
- DBClusterQuotaExceededFault
-
Il cluster non può essere creato perché hai raggiunto la quota massima consentita di cluster.
Codice di stato HTTP: 403
- DBClusterSnapshotNotFoundFault
-
DBClusterSnapshotIdentifier
non fa riferimento a un'istantanea del cluster esistente.Codice di stato HTTP: 404
- DBSnapshotNotFound
-
DBSnapshotIdentifier
non fa riferimento a un'istantanea esistente.Codice di stato HTTP: 404
- DBSubnetGroupNotFoundFault
-
DBSubnetGroupName
non fa riferimento a un gruppo di sottoreti esistente.Codice di stato HTTP: 404
- DBSubnetGroupNotFoundFault
-
DBSubnetGroupName
non fa riferimento a un gruppo di sottoreti esistente.Codice di stato HTTP: 404
- InsufficientDBClusterCapacityFault
-
Il cluster non dispone di capacità sufficiente per l'operazione corrente.
Codice di stato HTTP: 403
- InsufficientStorageClusterCapacity
-
Lo spazio di archiviazione disponibile non è sufficiente per l'azione corrente. È possibile risolvere questo errore aggiornando il gruppo di sottoreti per utilizzare zone di disponibilità diverse con più spazio di archiviazione disponibile.
Codice di stato HTTP: 400
- InvalidDBClusterSnapshotStateFault
-
Il valore fornito non è uno stato valido di snapshot del cluster.
Codice di stato HTTP: 400
- InvalidDBSnapshotState
-
Lo stato dell'istantanea non consente l'eliminazione.
Codice di stato HTTP: 400
- InvalidRestoreFault
-
Non è possibile eseguire il ripristino da un backup su cloud privato virtuale (VPC) su un'istanza DB non VPC.
Codice di stato HTTP: 400
- InvalidSubnet
-
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.
Codice di stato HTTP: 400
- InvalidVPCNetworkStateFault
-
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la creazione a causa delle modifiche apportate.
Codice di stato HTTP: 400
- KMSKeyNotAccessibleFault
-
Si è verificato un errore durante l'accesso a una AWS KMS chiave.
Codice di stato HTTP: 400
- StorageQuotaExceeded
-
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.
Codice di stato HTTP: 400
- StorageQuotaExceeded
-
La richiesta comporterebbe il superamento della quantità di spazio di archiviazione consentita disponibile in tutte le istanze.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: