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 suprovisioned
. 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 suprovisioned
, è necessario impostare anche un valore perProvisionedThroughputInMibps
.▬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 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 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 unName
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 suprovisioned
.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 campoTimestamp
. Il valoreTimestamp
è il numero intero di secondi dal 1970-01-01T00:00:00Z. Il valoreSizeInBytes
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 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
- 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: