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
Crea una configurazione di replica che replica un EFS file system esistente in un nuovo file system di sola lettura. Per ulteriori informazioni, consulta Amazon EFS Replication nella Amazon EFS User Guide. La configurazione di replica specifica quanto segue:
-
File system di origine: il EFS file system che desideri replicare. Non è possibile utilizzare un file system scelto come file system di destinazione in un'altra configurazione di replica esistente.
-
Regione AWS — Il file system Regione AWS in cui viene creato il file system di destinazione. La EFS replica Amazon è disponibile Regioni AWS in tutto ciò che EFS è disponibile. La regione deve essere abilitata. Per ulteriori informazioni, consulta Managing Regioni AWS in the AWS General Reference Guide.
-
Configurazione del file system di destinazione: la configurazione del file system di destinazione in cui verrà replicato il file system di origine. In una configurazione di replica può esistere un solo file system di destinazione.
I parametri per la configurazione di replica includono:
-
ID del file system: l'ID del file system di destinazione per la replica. Se non viene fornito alcun ID, EFS crea un nuovo file system con le impostazioni predefinite. Per i file system esistenti, la protezione da sovrascrittura della replica del file system deve essere disabilitata. Per ulteriori informazioni, consulta Replica su un file system esistente.
-
Zona di disponibilità: se si desidera che il file system di destinazione utilizzi lo storage a zona unica, è necessario specificare la zona di disponibilità in cui creare il file system. Per ulteriori informazioni, consulta i tipi di EFS file system nella Amazon EFS User Guide.
-
Crittografia: tutti i file system di destinazione vengono creati con la crittografia a riposo abilitata. Puoi specificare la chiave AWS Key Management Service (AWS KMS) utilizzata per crittografare il file system di destinazione. Se non specifichi una KMS chiave, EFS viene utilizzata la tua KMS chiave gestita dal servizio per Amazon.
Nota
Dopo aver creato il file system, non puoi modificare la KMS chiave.
-
Per i nuovi file system di destinazione, le seguenti proprietà sono impostate di default:
-
Modalità prestazioni: la modalità di prestazioni del file system di destinazione corrisponde a quella del file system di origine, a meno che il file system di destinazione non utilizzi lo storage EFS One Zone. In tal caso, viene utilizzata la modalità Prestazioni a scopi generali. La modalità Prestazioni non può essere modificata.
-
Modalità Throughput: la modalità Throughput del file system di destinazione corrisponde a quella del file system di origine. Dopo aver creato il file system, è possibile modificare la modalità di throughput.
-
gestione del ciclo di vita: la gestione del ciclo di vita non è abilitata nel file system di destinazione. Puoi abilitare la gestione del ciclo di vita dopo aver creato il file system di destinazione.
-
Backup automatici: i backup giornalieri automatici sono abilitati nel file system di destinazione. Dopo aver creato il file system, è possibile modificare l'impostazione.
Per ulteriori informazioni, consulta Amazon EFS Replication nella Amazon EFS User Guide.
Sintassi della richiesta
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"
}
]
}URIParametri della richiesta
La richiesta utilizza i seguenti URI parametri.
- SourceFileSystemId
-
Speciifica il EFS file system Amazon che desideri 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})$Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- Destinations
-
Una matrice di oggetti di configurazione di destinazione. È supportato un solo oggetto di configurazione di destinazione.
Tipo: matrice di oggetti DestinationToCreate
Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"Region": "string",
"Status": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemRegion": "string"
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- CreationTime
-
Descrive quando è stata creata la configurazione di replica.
Tipo: Timestamp
- Destinations
-
Una matrice di oggetti di destinazione. È supportato un solo oggetto di destinazione.
Tipo: matrice di oggetti Destination
- OriginalSourceFileSystemArn
-
L'Amazon Resource Name (ARN) del EFS file system di origine originale nella configurazione di replica.
▬Tipo: stringa
- SourceFileSystemArn
-
L'Amazon Resource Name (ARN) del file system di origine corrente nella configurazione di replica.
▬Tipo: stringa
- SourceFileSystemId
-
L'ID del EFS file system Amazon di origine che viene replicato.
▬Tipo: stringa
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})$ - SourceFileSystemRegion
-
L'ambiente Regione AWS in cui si trova il EFS file system di origine.
▬Tipo: stringa
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
- BadRequest
-
Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.
HTTPCodice di stato: 400
- ConflictException
-
Restituito se il file system di origine in una replica è crittografato ma il file system di destinazione non è crittografato.
HTTPCodice di stato: 409
- FileSystemLimitExceeded
-
Restituito se Account AWS ha già creato il numero massimo di file system consentiti per account.
HTTPCodice di stato: 403
- FileSystemNotFound
-
Restituito se il
FileSystemIdvalore specificato non esiste in quello del richiedente. Account AWSHTTPCodice di stato: 404
- IncorrectFileSystemLifeCycleState
-
Restituito se lo stato del ciclo di vita del file system non è “disponibile”.
HTTPCodice di stato: 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.
HTTPCodice di stato: 503
- InternalServerError
-
Restituito se si è verificato un errore lato server.
HTTPCodice di stato: 500
- ReplicationNotFound
-
Restituito se il file system specificato non dispone di una configurazione di replica.
HTTPCodice di stato: 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.
HTTPCodice di stato: 400
- UnsupportedAvailabilityZone
-
Restituito se la EFS funzionalità Amazon richiesta non è disponibile nella zona di disponibilità specificata.
HTTPCodice di stato: 400
- ValidationException
-
Restituito se il AWS Backup servizio non è disponibile nel paese Regione AWS in cui è stata effettuata la richiesta.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
