UpdateFileSystem - Amazon Elastic File System

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

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" }

URIParametri della richiesta

La richiesta utilizza i seguenti URI parametri.

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

ProvisionedThroughputInMibps

(Facoltativo) La velocità effettiva, misurata in mebibyte al secondo (MiBps), che si desidera fornire per un file system in fase di creazione. 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 le EFSquote Amazon che puoi aumentare nella Amazon EFS User Guide.

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'azione ha esito positivo, il servizio restituisce una risposta HTTP 202.

I seguenti dati vengono restituiti in JSON formato dal 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 Using EFS Storage Classes nella Amazon EFS User Guide.

▬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

Amazon Resource Name (ARN) per il EFS file system, nel formatoarn: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 AmazonEFS.

▬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 utente 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 Name tag, 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 le modalità di throughput nella Amazon EFS User Guide.

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

HTTPCodice di stato: 400

FileSystemNotFound

Restituito se il FileSystemId valore specificato non esiste in quello del richiedente. Account AWS

HTTPCodice 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

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

TooManyRequests

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

HTTPCodice di stato: 429

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: