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à.

# RestoreClusterFromSnapshot
<a name="API_elastic_RestoreClusterFromSnapshot"></a>

Ripristina un cluster elastico da un'istantanea.

## Sintassi della richiesta
<a name="API_elastic_RestoreClusterFromSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot/snapshotArn/restore HTTP/1.1
Content-type: application/json

{
   "clusterName": "string",
   "kmsKeyId": "string",
   "shardCapacity": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "tags": { 
      "string" : "string" 
   },
   "vpcSecurityGroupIds": [ "string" ]
}
```

## Parametri della richiesta URI
<a name="API_elastic_RestoreClusterFromSnapshot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [snapshotArn](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-uri-snapshotArn"></a>
L'identificatore ARN dello snapshot del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_RestoreClusterFromSnapshot_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [clusterName](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-clusterName"></a>
Il nome del cluster elastico.  
Tipo: stringa  
Obbligatorio: sì

 ** [kmsKeyId](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-kmsKeyId"></a>
L'identificatore di chiave KMS da utilizzare per crittografare il nuovo cluster elastico di cluster Amazon DocumentDB.  
L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai creando un cluster utilizzando lo stesso account Amazon che possiede questa chiave di crittografia KMS, puoi utilizzare l'alias della chiave KMS anziché l'ARN come chiave di crittografia KMS.  
Se non viene specificata una chiave di crittografia qui, Amazon DocumentDB utilizza la chiave di crittografia predefinita creata da KMS per il tuo account. Il tuo account ha una chiave di crittografia predefinita diversa per ogni regione Amazon.  
▬Tipo: stringa  
Obbligatorio: no

 ** [shardCapacity](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-shardCapacity"></a>
La capacità di ogni shard nel nuovo cluster elastico ripristinato.  
Tipo: Integer  
Obbligatorio: no

 ** [shardInstanceCount](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-shardInstanceCount"></a>
Il numero di istanze di replica che si applicano a tutti gli shard del cluster elastico. `shardInstanceCount`Il valore 1 indica che esiste un'istanza di writer e tutte le istanze aggiuntive sono repliche che possono essere utilizzate per le letture e per migliorare la disponibilità.  
Tipo: Integer  
Obbligatorio: no

 ** [subnetIds](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-subnetIds"></a>
La sottorete Amazon EC2 IDs per il cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

 ** [tags](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-tags"></a>
Un elenco dei nomi di tag da assegnare al cluster elastico ripristinato, sotto forma di una matrice di coppie chiave-valore in cui la chiave è il nome del tag e il valore è il valore chiave.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

 ** [vpcSecurityGroupIds](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-vpcSecurityGroupIds"></a>
Un elenco di gruppi di sicurezza VPC EC2 da associare al cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_RestoreClusterFromSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_RestoreClusterFromSnapshot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_RestoreClusterFromSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-response-cluster"></a>
Restituisce informazioni su un cluster elastico ripristinato.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_RestoreClusterFromSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ServiceQuotaExceededException **   
La quota di servizio per l'azione è stata superata.  
Codice di stato HTTP: 402

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

## Vedi anche
<a name="API_elastic_RestoreClusterFromSnapshot_SeeAlso"></a>

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-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot)