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à.
# RestoreDBClusterToPointInTime
Ripristina un cluster a un punto temporale arbitrario. Gli utenti possono ripristinare a qualsiasi point-in-time prima di `LatestRestorableTime` per un massimo di `BackupRetentionPeriod` giorni. Il cluster di destinazione viene creato dal cluster di origine con la stessa configurazione del cluster originale, 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](CommonParameters.md).
** DBClusterIdentifier **
Il nome del nuovo cluster da creare.
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.
Tipo: stringa
Obbligatorio: sì
** SourceDBClusterIdentifier **
L'identificativo del cluster di origine dal quale eseguire il ripristino.
Vincoli:
+ Deve corrispondere all'identificativo di un `DBCluster` esistente.
Tipo: stringa
Obbligatorio: sì
** DBSubnetGroupName **
Il nome del gruppo di sottoreti da utilizzare per il nuovo cluster.
Vincoli: se fornito, deve corrispondere al nome di un esistente. `DBSubnetGroup`
Ad esempio: `mySubnetgroup`
▬Tipo: stringa
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. `DeletionProtection`protegge i cluster dall'eliminazione accidentale.
Tipo: Booleano
Obbligatorio: no
**EnableCloudwatchLogsExports.Member.**
Un elenco di tipi di log che devono essere abilitati per l'esportazione in Amazon CloudWatch Logs.
Tipo: array di stringhe
Obbligatorio: no
** KmsKeyId **
L'identificatore della AWS KMS chiave da utilizzare per ripristinare un cluster crittografato da un cluster crittografato.
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
È possibile eseguire il ripristino in un nuovo cluster e crittografare il nuovo cluster con una AWS KMS chiave diversa da quella utilizzata per crittografare il AWS KMS cluster di origine. Il nuovo cluster DB è crittografato con la AWS KMS chiave identificata dal `KmsKeyId` parametro.
Se non specifichi un valore per il parametro `KmsKeyId`, avviene quanto segue:
+ Se il cluster è crittografato, il cluster ripristinato viene crittografato utilizzando la AWS KMS chiave utilizzata per crittografare il cluster di origine.
+ Se il cluster non è crittografato, il cluster ripristinato non è crittografato.
Se `DBClusterIdentifier` si riferisce a un cluster non crittografato, la richiesta di ripristino viene rifiutata.
▬Tipo: stringa
Obbligatorio: no
** NetworkType **
Il tipo di rete del cluster.
Il tipo di rete è determinato da quello `DBSubnetGroup` specificato per il cluster. A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv4 e i IPv6 protocolli (`DUAL`).
Per ulteriori informazioni, consulta [DocumentDB clusters in a VPC nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) Amazon DocumentDB Developer Guide.
Valori validi: `IPV4` \$1 `DUAL`
▬Tipo: stringa
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`
Predefinita: la porta predefinita per il motore.
Tipo: Integer
Obbligatorio: no
** RestoreToTime **
La data e l'ora alle quali ripristinare il cluster.
Valori validi: un orario in formato Universal Coordinated Time (UTC).
Vincoli:
+ Deve essere antecedente all'ultimo orario ripristinabile per l'istanza.
+ Deve essere specificato se il parametro `UseLatestRestorableTime` non viene fornito.
+ Non può essere specificato se il parametro `UseLatestRestorableTime` è `true`.
+ Non può essere specificato se il parametro `RestoreType` è `copy-on-write`.
Ad esempio: `2015-03-07T23:45:00Z`
Tipo: Timestamp
Obbligatorio: no
** RestoreType **
Il tipo di ripristino da eseguire. È possibile specificare uno dei seguenti valori:
+ `full-copy`: il nuovo cluster database viene ripristinato come una copia completa del cluster database di origine.
+ `copy-on-write`: il nuovo cluster database viene ripristinato come un clone del cluster database di origine.
Vincoli: non puoi specificare `copy-on-write` se la versione del motore del cluster di database di origine è precedente alla 1.11.
Se non si specifica un valore `RestoreType`, il nuovo cluster di database viene ripristinato come una copia completa del cluster di database di origine.
▬Tipo: stringa
Obbligatorio: no
** ServerlessV2ScalingConfiguration **
Contiene la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.
Tipo: oggetto [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)
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
Obbligatorio: no
**Tags.Tag.N**
I tag da assegnare al cluster ripristinato.
Tipo: matrice di oggetti [Tag](API_Tag.md)
Obbligatorio: no
** UseLatestRestorableTime **
Un valore impostato su `true` per ripristinare il cluster all'ora dell'ultimo backup ripristinabile; in alternativa è impostato su `false`.
Impostazione predefinita: `false`
Vincoli: non può essere specificato se viene fornito il parametro `RestoreToTime`.
Tipo: Booleano
Obbligatorio: no
**VpcSecurityGroupIds. VpcSecurityGroupId**N.
Un elenco di gruppi di sicurezza VPC a cui appartiene il nuovo cluster.
Tipo: array di stringhe
Obbligatorio: no
## Elementi di risposta
Il servizio restituisce il seguente elemento.
** DBCluster **
Informazioni dettagliate su un cluster.
Tipo: oggetto [DBCluster](API_DBCluster.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
** DBClusterAlreadyExistsFault **
Hai già un cluster con l'identificatore fornito.
Codice di stato HTTP: 400
** DBClusterNotFoundFault **
`DBClusterIdentifier`non fa riferimento a un cluster esistente.
Codice di stato HTTP: 404
** 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
** 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 in modo che utilizzi 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
** InvalidDBClusterStateFault **
Il cluster non è in uno stato valido.
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
** NetworkTypeNotSupported **
Il tipo di rete non è supportato `DBSubnetGroup` né dalla versione del motore DB.
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
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RestoreDBClusterToPointInTime)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RestoreDBClusterToPointInTime)