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à. # CreateFileSystem Crea un nuovo file system vuoto. Nella richiesta, l'operazione richiede un token di creazione che Amazon EFS utilizza per garantire una creazione idempotente (chiamare l'operazione con lo stesso token non ha effetto). Se attualmente non esiste un file system di proprietà del chiamante Account AWS con il token di creazione specificato, questa operazione esegue le seguenti operazioni: + Crea un nuovo file system vuoto. Il file system avrà un ID assegnato da Amazon EFS e uno stato iniziale `creating` per il ciclo di vita. + Restituisce la descrizione del file system creato. In caso contrario, questa operazione restituisce un errore `FileSystemAlreadyExists` con l'ID del file system esistente. **Nota** Per i casi d'uso di base, è possibile utilizzare un UUID generato in modo casuale per il token di creazione. L'operazione idempotente consente di tentare nuovamente una chiamata `CreateFileSystem` senza rischiare di creare un ulteriore file system. Questo può accadere quando una prima chiamata ha esito negativo senza fornire indicazioni certe sull'effettiva creazione del file system. Un esempio potrebbe essere il verificarsi di un timeout a livello di trasporto o il ripristino della connessione. Se si utilizza lo stesso token di creazione e la chiamata iniziale è riuscita a creare un file system, con l'errore `FileSystemAlreadyExists` il client saprà della sua esistenza. Per ulteriori informazioni, consulta la sezione relativa alla [Creazione di un file system](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1) della *Guida per l'utente di Amazon EFS*. **Nota** La chiamata `CreateFileSystem` risponde mentre il ciclo di vita del file system è ancora `creating`. È possibile controllare lo stato di creazione del file system chiamando l'operazione [DescribeFileSystems](API_DescribeFileSystems.md) che, tra altri elementi, ne restituirà lo stato. L'operazione include anche un parametro `PerformanceMode` opzionale che è possibile scegliere per il file system. Consigliamo l'uso `generalPurpose` `PerformanceMode` per tutti i file system. La `maxIO` modalità è un tipo di prestazioni della generazione precedente progettata per carichi di lavoro altamente parallelizzati che possono tollerare latenze più elevate rispetto alla modalità. `generalPurpose` `MaxIO`la modalità non è supportata per i file system One Zone o per i file system che utilizzano la velocità effettiva elastica. Non `PerformanceMode` può essere modificata dopo la creazione del file system. Per ulteriori informazioni, consulta [Amazon EFS: modalità prestazionali](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html). È possibile impostare la modalità di throughput per il file system utilizzando il parametro `ThroughputMode`. Una volta completamente creato il file system, Amazon EFS ne imposta lo stato del ciclo di vita su `available`. A questo punto è possibile creare una o più target di montaggio per il file system nel VPC. Per ulteriori informazioni, consulta [CreateMountTarget](API_CreateMountTarget.md). Puoi montare il tuo file system Amazon EFS su un' EC2 istanza nel tuo VPC utilizzando la destinazione di montaggio. Per ulteriori informazioni, consulta [Amazon EFS: come funziona](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html). Questa operazione richiede le autorizzazioni per l'operazione `elasticfilesystem:CreateFileSystem`. I file system possono essere etichettati al momento della creazione. Se i tag vengono specificati nell'azione di creazione delle risorse, IAM esegue autorizzazioni aggiuntive per l'azione `elasticfilesystem:TagResource` per verificare se gli utenti dispongono delle autorizzazioni per creare tag. Pertanto, devi concedere le autorizzazioni esplicite per utilizzare l'operazione `elasticfilesystem:TagResource`. Per ulteriori informazioni, consulta [Concessione dell'autorizzazione all'assegnazione di tag per le risorse durante la creazione](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html). ## Sintassi della richiesta ``` POST /2015-02-01/file-systems HTTP/1.1 Content-type: application/json { "AvailabilityZoneName": "string", "Backup": boolean, "CreationToken": "string", "Encrypted": boolean, "KmsKeyId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) ** Per i file system One Zone, specifica la zona di AWS disponibilità in cui creare il file system. Utilizzare il formato `us-east-1a` per specificare la zona di disponibilità. Per ulteriori informazioni sui file system One Zone, consulta i [tipi di file system EFS](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) nella *Amazon EFS User Guide*. I file system One Zone non sono disponibili in tutte le zone di disponibilità in Regioni AWS cui è disponibile Amazon EFS. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `.+` Obbligatorio: no ** [Backup](#API_CreateFileSystem_RequestSyntax) ** Specifica se i backup automatici sono abilitati sul file system che si sta creando. Imposta il valore su `true` per abilitare i backup automatici. Se stai creando un file system a zona singola, i backup automatici sono abilitati per impostazione predefinita. Per ulteriori informazioni, consulta [Backup automatici](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) nella *Guida per l'utente di Amazon EFS*. Il valore predefinito è “`false`”. Tuttavia, se si specifica `AvailabilityZoneName`, l'impostazione predefinita è `true`. AWS Backup non è disponibile in tutti i paesi in Regioni AWS cui è disponibile Amazon EFS. Tipo: Booleano Obbligatorio: no ** [CreationToken](#API_CreateFileSystem_RequestSyntax) ** Stringa contenente un massimo di 64 caratteri ASCII. Amazon EFS utilizza questo sistema per garantire la creazione idempotente. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `.+` Obbligatorio: sì ** [Encrypted](#API_CreateFileSystem_RequestSyntax) ** Un valore booleano che, se true, crea un file system crittografato. Quando crei un file system crittografato, hai la possibilità di specificare una AWS Key Management Service chiave esistente (chiave KMS). Se non specifichi una chiave KMS, la chiave KMS predefinita per Amazon EFS, `/aws/elasticfilesystem`, viene utilizzata per proteggere il file system crittografato. Tipo: Booleano Obbligatorio: no ** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) ** L'ID della chiave KMS che si desidera utilizzare per proteggere il file system crittografato. Questo parametro è necessario solo se desideri utilizzare una chiave KMS non predefinita. Se il parametro non è specificato, viene utilizzata la chiave KMS predefinita per Amazon EFS. È possibile specificare un ID chiave KMS utilizzando i seguenti formati: + ID chiave: un identificatore univoco della chiave, ad esempio `1234abcd-12ab-34cd-56ef-1234567890ab`. + ARN: un ARN (Amazon Resource Name) per la chiave, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`. + Alias chiave: un nome di visualizzazione creato in precedenza per una chiave, ad esempio `alias/projectKey1`. + ARN alias della chiave: un ARN per un alias della chiave, ad esempio `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`. [Se si utilizza`KmsKeyId`, è necessario impostare il parametro:Encrypted su trueCreateFileSystem.](#efs-CreateFileSystem-request-Encrypted) EFS accetta solo chiavi KMS simmetriche. Non puoi usare chiavi KMS asimmetriche con i file system Amazon EFS. Tipo: String Limitazioni di lunghezza: lunghezza massima di 2048. Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$` Obbligatorio: no ** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) ** Le modalità di prestazioni dei file system. Consigliamo la modalità Prestazioni `generalPurpose` per la maggior parte dei file system. I file system che utilizzano la performance `maxIO` sono in grado di ridimensionare le risorse a livelli maggiori di throughput aggregato e di operazioni al secondo, con un compromesso di latenze leggermente più elevate per la maggior parte delle operazioni sui file. La modalità prestazionale non può essere modificata dopo la creazione del file system. La modalità `maxIO` non è supportata sui file system a zona singola. A causa delle più elevate latenze per operazione con I/O max, consigliamo di utilizzare la modalità prestazionale a scopi generali per tutti i file system. Il valore predefinito è “`generalPurpose`”. Tipo: String Valori validi: `generalPurpose | maxIO` Campo obbligatorio: no ** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) ** La velocità effettiva, misurata in mebibyte al secondo (MiBps), che desideri fornire per il file system che stai creando. Obbligatorio se `ThroughputMode` è impostato su `provisioned`. I valori validi sono 1-3414 MiBps, con il limite superiore a seconda della regione. Per aumentare questo limite, contatta. Supporto Per ulteriori informazioni, consulta [Quote di Amazon EFS che è possibile incrementare](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) nella *Guida per l'utente di Amazon EFS*. Tipo: numero a doppia precisione Intervallo valido: valore minimo di 1.0. Obbligatorio: no ** [Tags](#API_CreateFileSystem_RequestSyntax) ** Utilizza per creare uno o più tag associati al file system. Ogni tag è una coppia chiave-valore definita dall'utente. Denominare il file system quando viene creato, includendo una coppia chiave-valore `"Key":"Name","Value":"{value}"`. Ogni chiave deve essere univoca. Per ulteriori informazioni, consulta [Taggare AWS le risorse](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) nella *Guida di riferimento AWS generale*. Tipo: matrice di oggetti [Tag](API_Tag.md) Obbligatorio: no ** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) ** Specifica la modalità della velocità di trasmissione effettiva per il file system. La modalità può essere `bursting`, `provisioned` o `elastic`. Se `ThroughputMode` è impostato su `provisioned`, è necessario impostare anche un valore per `ProvisionedThroughputInMibps`. Dopo avere creato il file system, puoi ridurre la velocità di trasmissione effettiva del file system nella modalità con provisioning o passare a un'altra modalità di velocità di trasmissione effettiva, con determinate limitazioni di tempo. Per ulteriori informazioni, consulta [Specifica del throughput nella modalità Provisioned](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput) nella *Guida per l'utente di Amazon EFS.* Il valore predefinito è “`bursting`”. Tipo: String Valori validi: `bursting | provisioned | elastic` Campo obbligatorio: no ## Sintassi della risposta ``` HTTP/1.1 201 Content-type: application/json { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "CreationTime": number, "CreationToken": "string", "Encrypted": boolean, "FileSystemArn": "string", "FileSystemId": "string", "FileSystemProtection": { "ReplicationOverwriteProtection": "string" }, "KmsKeyId": "string", "LifeCycleState": "string", "Name": "string", "NumberOfMountTargets": number, "OwnerId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "SizeInBytes": { "Timestamp": number, "Value": number, "ValueInArchive": number, "ValueInIA": number, "ValueInStandard": number }, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 201. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) ** L'identificatore univoco e coerente della zona di disponibilità in cui si trova il file system, valido solo per i file system a zona singola. Ad esempio, `use1-az1` è un ID della zona di disponibilità per Regione AWS us-east-1 e ha la stessa posizione in tutti. Account AWS Tipo: String ** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) ** Descrive la zona di AWS disponibilità in cui si trova il file system ed è valido solo per i file system a zona singola. Per ulteriori informazioni, consulta [Utilizzo delle classi di archiviazione EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) nella *Guida per l'utente di Amazon EFS*. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `.+` ** [CreationTime](#API_CreateFileSystem_ResponseSyntax) ** L'ora di creazione del file system, in secondi (da 1970-01-01T00:00:00Z). Tipo: Timestamp ** [CreationToken](#API_CreateFileSystem_ResponseSyntax) ** Stringa opaca specificata nella richiesta. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `.+` ** [Encrypted](#API_CreateFileSystem_ResponseSyntax) ** Valore booleano che, se "true", indica che il file system è crittografato. Tipo: Booleano ** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) ** Il nome della risorsa Amazon (ARN) per il file system Amazon EFS in formato `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id `. Esempio con dati campione: `arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567` Tipo: String ** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) ** L'ID del file system, assegnato da Amazon EFS. 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})$` ** [FileSystemProtection](#API_CreateFileSystem_ResponseSyntax) ** Descrive la protezione del file system. Tipo: oggetto [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) ** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) ** L'ID di un file AWS KMS key utilizzato per proteggere il file system crittografato. Tipo: String Limitazioni di lunghezza: lunghezza massima di 2048. Pattern: `^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$` ** [LifeCycleState](#API_CreateFileSystem_ResponseSyntax) ** La fase del ciclo di vita del file system. Tipo: String Valori validi: `creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateFileSystem_ResponseSyntax) ** È possibile aggiungere tag a un file system, incluso un tag `Name`. Per ulteriori informazioni, consulta [CreateFileSystem](#API_CreateFileSystem). Se il file system ha un tag `Name`, Amazon EFS restituisce il valore in questo campo. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` ** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) ** Il numero attuale di target di montaggio del file system. Per ulteriori informazioni, consulta [CreateMountTarget](API_CreateMountTarget.md). Tipo: numero intero Intervallo valido: valore minimo di 0. ** [OwnerId](#API_CreateFileSystem_ResponseSyntax) ** Quello Account AWS che ha creato il file system. Tipo: String Limitazioni di lunghezza: lunghezza massima di 14. Modello: `^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) ** Le modalità di prestazioni dei file system. Tipo: String Valori validi: `generalPurpose | maxIO` ** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) ** La quantità di velocità effettiva assegnata, misurata in MiBps, per il file system. Valido per i file system che utilizzano `ThroughputMode` impostato su `provisioned`. Tipo: numero a doppia precisione Intervallo valido: valore minimo di 1.0. ** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) ** L'ultima dimensione misurata nota (in byte) dei dati memorizzati nel file system, nel relativo campo `Value` e l'ora in cui tale dimensione è stata determinata nel campo `Timestamp`. Il valore `Timestamp` è il numero intero di secondi dal 1970-01-01T00:00:00Z. Il valore `SizeInBytes` non rappresenta la dimensione di un'istantanea coerente del file system, ma è coerente quando non vi sono operazioni di scrittura sul file system. Ossia, `SizeInBytes` rappresenta la dimensione effettiva solo se il file system non viene modificato per un periodo superiore a un paio d'ore. Altrimenti, il valore non corrisponde alla dimensione esatta che aveva il file system in qualsiasi momento. Tipo: oggetto [FileSystemSize](API_FileSystemSize.md) ** [Tags](#API_CreateFileSystem_ResponseSyntax) ** I tag associati al file system, presentati come una serie di oggetti `Tag`. Tipo: matrice di oggetti [Tag](API_Tag.md) ** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) ** Visualizza la modalità di throughput per un file system. Per ulteriori informazioni, consulta [Modalità di throughput](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes) nella *Guida per l'utente di Amazon EFS*. Tipo: String Valori validi: `bursting | provisioned | elastic` ## 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. ** 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 ** FileSystemAlreadyExists ** Restituito se il file system che si sta cercando di creare esiste già, con il token di creazione fornito. ** 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 ha già 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 ** 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 ** 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 MiB/s 1024. ** 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 ## Esempi ### Creazione di un file system EFS crittografato L'esempio seguente invia una richiesta POST per creare un file system nella regione `us-west-2` con i backup automatici abilitati. La richiesta specifica `myFileSystem1` come token di creazione per l'idempotenza. #### Richiesta di esempio ``` POST /2015-02-01/file-systems HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215117Z Authorization: <...> Content-Type: application/json Content-Length: 42 { "CreationToken" : "myFileSystem1", "PerformanceMode" : "generalPurpose", "Backup": true, "Encrypted": true, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ] } ``` #### Risposta di esempio ``` HTTP/1.1 201 Created x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 319 { "ownerId":"251839141158", "CreationToken":"myFileSystem1", "Encrypted": true, "PerformanceMode" : "generalPurpose", "fileSystemId":"fs-01234567", "CreationTime":"1403301078", "LifeCycleState":"creating", "numberOfMountTargets":0, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 }, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ], "ThroughputMode": "elastic" } ``` ### Creazione di un file system EFS crittografato con disponibilità a zona singola L'esempio seguente invia una richiesta POST per creare un file system nella regione `us-west-2` con i backup automatici abilitati. Il file system disporrà di una sola zona di archiviazione nella zona di disponibilità `us-west-2b`. #### Richiesta di esempio ``` POST /2015-02-01/file-systems HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215117Z Authorization: <...> Content-Type: application/json Content-Length: 42 { "CreationToken" : "myFileSystem2", "PerformanceMode" : "generalPurpose", "Backup": true, "AvailabilityZoneName": "us-west-2b", "Encrypted": true, "ThroughputMode": "elastic", "Tags":[ { "Key": "Name", "Value": "Test Group1" } ] } ``` #### Risposta di esempio ``` HTTP/1.1 201 Created x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 319 { "ownerId":"251839141158", "CreationToken":"myFileSystem1", "Encrypted": true, "AvailabilityZoneId": "usew2-az2", "AvailabilityZoneName": "us-west-2b", "PerformanceMode" : "generalPurpose", "fileSystemId":"fs-01234567", "CreationTime":"1403301078", "LifeCycleState":"creating", "numberOfMountTargets":0, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 }, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ], "ThroughputMode": "elastic" } ``` ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem)