Sintassi della richiesta Parametri della richiesta URI:Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Esempi Vedi anche

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

È 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. È possibile montare il file system Amazon EFS su un'istanza EC2 nel VPC utilizzando il target di montaggio. Per ulteriori informazioni, consulta Amazon EFS: come funziona.

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.

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

Per i file system One Zone, specificare 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 nella Amazon EFS User Guide.

Nota

I file system One Zone non sono disponibili in tutte le zone di disponibilità in Regioni AWS cui è disponibile Amazon EFS.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: .+

Campo obbligatorio: no

Backup

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 nella Guida per l'utente di Amazon EFS.

Il valore predefinito è false. Tuttavia, se si specifica AvailabilityZoneName, l'impostazione predefinita è true.

Nota

AWS Backup non è disponibile Regioni AWS ovunque sia disponibile Amazon EFS.

Tipo: Booleano

Campo obbligatorio: no

CreationToken

Stringa contenente un massimo di 64 caratteri ASCII. Amazon EFS utilizza questo sistema per garantire la creazione idempotente.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: .+

Campo obbligatorio: sì

Encrypted

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

Campo obbligatorio: no

KmsKeyId

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 utilizzaKmsKeyId, è necessario impostare il parametro CreateFileSystem:Encrypted su true.

Importante

EFS accetta solo chiavi KMS simmetriche. Non puoi usare chiavi KMS asimmetriche con i file system Amazon EFS.

▬Tipo: stringa

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/_-]+))))$

Campo obbligatorio: no

PerformanceMode

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.

Importante

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: stringa

Valori validi: generalPurpose | maxIO

Campo obbligatorio: no

ProvisionedThroughputInMibps

La velocità effettiva, misurata in mebibyte al secondo (MiBps), che si desidera fornire per il file system che si sta 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. AWS Support Per ulteriori informazioni, consulta Quote di Amazon EFS che è possibile incrementare nella Guida per l'utente di Amazon EFS.

Tipo: double

Intervallo valido: valore minimo di 1.0.

Campo obbligatorio: no

Tags

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 nella Guida di riferimento AWS generale.

Tipo: matrice di oggetti Tag

Campo obbligatorio: no

ThroughputMode

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 nella Guida per l'utente di Amazon EFS.

Il valore predefinito è bursting.

▬Tipo: stringa

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

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: stringa

AvailabilityZoneName

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 nella Guida per l'utente di Amazon EFS.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: .+

CreationTime

L'ora di creazione del file system, in secondi (da 1970-01-01T00:00:00Z).

Tipo: Timestamp

CreationToken

Stringa opaca specificata nella richiesta.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: .+

Encrypted

Valore booleano che, se "true", indica che il file system è crittografato.

Tipo: Booleano

FileSystemArn

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: stringa

FileSystemId

L'ID del file system, assegnato da Amazon EFS.

▬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})$

FileSystemProtection

Descrive la protezione del file system.

Tipo: oggetto FileSystemProtectionDescription

KmsKeyId

L'ID di un file AWS KMS key utilizzato per proteggere il file system crittografato.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 2048.

LifeCycleState

La fase del ciclo di vita del file system.

▬Tipo: stringa

Name

È possibile aggiungere tag a un file system, incluso un tag Name. Per ulteriori informazioni, consulta CreateFileSystem. Se il file system ha un tag Name, Amazon EFS restituisce il valore in questo campo.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

NumberOfMountTargets

Il numero attuale di target di montaggio del file system. Per ulteriori informazioni, consulta CreateMountTarget.

Tipo: integer

Intervallo valido: valore minimo di 0.

OwnerId

Quello Account AWS che ha creato il file system.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 14.

Modello: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

Le modalità di prestazioni dei file system.

▬Tipo: stringa

Valori validi: generalPurpose | maxIO

ProvisionedThroughputInMibps

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: double

Intervallo valido: valore minimo di 1.0.

SizeInBytes

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

Tags

I tag associati al file system, presentati come una serie di oggetti Tag.

Tipo: matrice di oggetti Tag

ThroughputMode

Visualizza la modalità di throughput per un file system. Per ulteriori informazioni, consulta Modalità di throughput nella Guida per l'utente di Amazon EFS.

▬Tipo: stringa

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.

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.

Codice di stato HTTP: 409

FileSystemLimitExceeded

Restituito se Account AWS ha già creato il numero massimo di file system consentiti per account.

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.

Codice di stato HTTP: 503

InternalServerError

Restituito se si è verificato un errore lato server.

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 1024 MiB/s.

Codice di stato HTTP: 400

UnsupportedAvailabilityZone

Restituito se la funzionalità Amazon EFS richiesta non è disponibile nella zona di disponibilità specificata.

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 uno degli AWS SDK specifici della lingua, consulta quanto segue:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CreateAccessPoint

CreateMountTarget