RestoreDBClusterFromSnapshot - Amazon DocumentDB

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 e DeletionProtection disabilitato. DeletionProtectionprotegge 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 a1150. 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

DBClusterSnapshotIdentifiernon fa riferimento a un'istantanea del cluster esistente.

Codice di stato HTTP: 404

DBSnapshotNotFound

DBSnapshotIdentifiernon fa riferimento a un'istantanea esistente.

Codice di stato HTTP: 404

DBSubnetGroupNotFoundFault

DBSubnetGroupNamenon fa riferimento a un gruppo di sottoreti esistente.

Codice di stato HTTP: 404

DBSubnetGroupNotFoundFault

DBSubnetGroupNamenon 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: