

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

# CreateReplicationConfiguration
<a name="API_CreateReplicationConfiguration"></a>

Crea una configurazione di replica su un file system EFS nuovo o esistente. Per ulteriori informazioni, consulta [Replica Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html) nella *Guida per l'utente di Amazon EFS*. La configurazione di replica specifica quanto segue:
+  **File system di origine**: il file system EFS che si desidera replicare. 
+  **File system di destinazione**: il file system di destinazione in cui viene replicato il file system di origine. In una configurazione di replica può esistere un solo file system di destinazione. 
**Nota**  
Un file system può far parte di una sola configurazione di replica. 

  I parametri di destinazione per la configurazione di replica dipendono dal fatto che si stia eseguendo la replica su un nuovo file system o su un file system esistente e se si stia eseguendo la replica su più file. Account AWS Per ulteriori informazioni, consulta [DestinationToCreate](API_DestinationToCreate.md).

Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:CreateReplicationConfiguration`. Inoltre, sono necessarie altre autorizzazioni a seconda della modalità di replica dei file system. Per ulteriori informazioni, consulta [Autorizzazioni richieste per la replica nella Guida](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions) per l'*utente di Amazon EFS*.

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

```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json

{
   "Destinations": [ 
      { 
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "KmsKeyId": "string",
         "Region": "string",
         "RoleArn": "string"
      }
   ]
}
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **   <a name="efs-CreateReplicationConfiguration-request-uri-SourceFileSystemId"></a>
Specifica il file system Amazon EFS da replicare. Questo file system non può essere già un file system di origine o di destinazione in un'altra configurazione di replica.  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obbligatorio: sì

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **   <a name="efs-CreateReplicationConfiguration-request-Destinations"></a>
Una matrice di oggetti di configurazione di destinazione. È supportato un solo oggetto di configurazione di destinazione.  
Tipo: matrice di oggetti [DestinationToCreate](API_DestinationToCreate.md)  
Obbligatorio: sì

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

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

{
   "CreationTime": number,
   "Destinations": [ 
      { 
         "FileSystemId": "string",
         "LastReplicatedTimestamp": number,
         "OwnerId": "string",
         "Region": "string",
         "RoleArn": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ],
   "OriginalSourceFileSystemArn": "string",
   "SourceFileSystemArn": "string",
   "SourceFileSystemId": "string",
   "SourceFileSystemOwnerId": "string",
   "SourceFileSystemRegion": "string"
}
```

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

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

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

 ** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-CreationTime"></a>
Descrive quando è stata creata la configurazione di replica.  
Tipo: Timestamp

 ** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-Destinations"></a>
Una matrice di oggetti di destinazione. È supportato un solo oggetto di destinazione.  
Tipo: matrice di oggetti [Destination](API_Destination.md)

 ** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-OriginalSourceFileSystemArn"></a>
Il nome della risorsa Amazon (ARN) del file system EFS originale nella configurazione di replica.  
Tipo: String

 ** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemArn"></a>
Il nome della risorsa Amazon (ARN) del file system EFS originale nella configurazione di replica.  
Tipo: String

 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemId"></a>
ID del file system Amazon EFS di origine che viene replicato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 

 ** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemOwnerId"></a>
ID del file system di origine Account AWS in cui risiede.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 14.  
Modello: `^(\d{12})|(\d{4}-\d{4}-\d{4})$` 

 ** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **   <a name="efs-CreateReplicationConfiguration-response-SourceFileSystemRegion"></a>
Il file system EFS di origine Regione AWS in cui si trova.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$` 

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

 ** BadRequest **   
Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400

 ** ConflictException **   
Restituito se il file system di origine in una replica è crittografato ma il file system di destinazione non è crittografato.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 409

 ** FileSystemLimitExceeded **   
Restituito se Account AWS è già stato creato il numero massimo di file system consentiti per account.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 403

 ** FileSystemNotFound **   
Restituito se il `FileSystemId` valore specificato non esiste nel file del richiedente. Account AWS    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 404

 ** IncorrectFileSystemLifeCycleState **   
Restituito se lo stato del ciclo di vita del file system non è “disponibile”.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 409

 ** InsufficientThroughputCapacity **   
Restituito se la capacità non è sufficiente per fornire un throughput aggiuntivo. Questo valore può essere restituito quando si tenta di creare un file system in modalità di throughput assegnato, quando si tenta di aumentare la velocità di trasmissione effettiva assegnata di un file system esistente o quando si tenta di modificare un file system esistente dalla modalità Bursting alla modalità Con provisioning. Riprova più tardi.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 503

 ** InternalServerError **   
Restituito se si è verificato un errore lato server.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 500

 ** ReplicationNotFound **   
Restituito se il file system specificato non dispone di una configurazione di replica.    
 ** ErrorCode **   
ReplicationNotFound  
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 404

 ** ThroughputLimitExceeded **   
Restituito se la modalità di throughput o la quantità di throughput assegnata non possono essere modificate perché è stato raggiunto il limite di throughput di 1024. MiB/s     
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400

 ** UnsupportedAvailabilityZone **   
Restituito se la funzionalità Amazon EFS richiesta non è disponibile nella zona di disponibilità specificata.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400

 ** ValidationException **   
Restituito se il AWS Backup servizio non è disponibile nel paese Regione AWS in cui è stata effettuata la richiesta.    
 ** ErrorCode **   
Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo.   
 ** Message **   
Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore.
Codice di stato HTTP: 400

## Vedi anche
<a name="API_CreateReplicationConfiguration_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/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) 