UpdateFileSystem

Aggiorna la modalità di throughput o la quantità di throughput assegnato di un file system esistente.

Sintassi della richiesta

PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json

{
   "ProvisionedThroughputInMibps": number,
   "ThroughputMode": "string"
}

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

FileSystemId

L'ID del file system che si desidera aggiornare.

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 in formato JSON.

ProvisionedThroughputInMibps

(Facoltativo) 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. 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

ThroughputMode

(Facoltativo) Aggiorna la modalità di trasmissione del file system. Se non state aggiornando la modalità di throughput, non è necessario fornire questo valore nella richiesta. Se ThroughputMode è impostato su provisioned, è necessario impostare anche un valore per ProvisionedThroughputInMibps.

▬Tipo: stringa

Valori validi: bursting | provisioned | elastic

Campo obbligatorio: no

Sintassi della risposta

HTTP/1.1 202
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 202.

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.

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

La fase del ciclo di vita del file system.

▬Tipo: stringa

Valori validi: creating | available | updating | deleting | deleted | error

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

FileSystemNotFound

Restituito se il FileSystemId valore specificato non esiste nel file del richiedente. Account AWS

Codice di stato HTTP: 404

IncorrectFileSystemLifeCycleState

Restituito se lo stato del ciclo di vita del file system non è “disponibile”.

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.

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

TooManyRequests

Restituito se non si attendono almeno 24 ore prima di modificare la modalità di throughput o di ridurre il valore del Provisioned Throughput.

Codice di stato HTTP: 429

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:

• Interfaccia a riga di comando AWS

• AWS SDK per.NET

• AWS SDK per C++

• AWS SDK per Go v2

• AWS SDK per Java V2

• AWS SDK per V3 JavaScript

• AWS SDK per PHP V3

• AWS SDK per Python

• AWS SDK per Ruby V3