Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Aktualisiert den Durchsatz oder die Menge des bereitgestellten Durchsatzes eines vorhandenen Dateisystems.
Anforderungssyntax
PUT /2015-02-01/file-systems/FileSystemId
HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number
,
"ThroughputMode": "string
"
}
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- FileSystemId
-
Die ID des Dateisystems, das Sie aktualisieren möchten.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
Erforderlich: Ja
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- ProvisionedThroughputInMibps
-
(Optional) Der Durchsatz, gemessen in Mebibyte pro Sekunde (MiBps), den Sie für ein Dateisystem bereitstellen möchten, das Sie erstellen. Erforderlich, wenn
ThroughputMode
aufprovisioned
festgelegt wird. Gültige Werte sind 1—3414 MiBps, wobei die Obergrenze von der Region abhängt. Um diesen Grenzwert zu erhöhen, wenden Sie sich an. Support Weitere Informationen finden Sie unter Amazon-EFS-Kontingente, die Sie erhöhen können im Amazon-EFS-Benutzerhandbuch.Type: Double
Gültiger Bereich: Mindestwert 1.0.
Erforderlich: Nein
- ThroughputMode
-
(Optional) Aktualisiert den Durchsatzmodus des Dateisystems. Wenn Sie Ihren Durchsatzmodus nicht aktualisieren, müssen Sie diesen Wert in Ihrer Anfrage nicht angeben. Wenn Sie
ThroughputMode
inprovisioned
ändern, müssen Sie auch einen Wert fürProvisionedThroughputInMibps
festlegen.Typ: Zeichenfolge
Zulässige Werte:
bursting | provisioned | elastic
Erforderlich: Nein
Antwortsyntax
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"
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 202-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- AvailabilityZoneId
-
Die eindeutige und konsistente Kennung der Availability Zone, in der sich das Dateisystem befindet. Sie ist nur für One-Zone-Dateisysteme gültig.
use1-az1
Ist beispielsweise eine Availability Zone ID für die US-East-1 AWS-Region, und sie hat in jedem Fall den gleichen Standort. AWS-KontoTyp: Zeichenfolge
- AvailabilityZoneName
-
Beschreibt die AWS Availability Zone, in der sich das Dateisystem befindet, und ist nur für One Zone-Dateisysteme gültig. Weitere Informationen finden Sie unter Verwenden von EFS-Speicherklassen im Amazon-EFS-Benutzerhandbuch.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern:
.+
- CreationTime
-
Die Zeit, zu der das Dateisystem erstellt wurde, in Sekunden (seit 1970-01-01T00:00:00Z).
Typ: Zeitstempel
- CreationToken
-
Die Opaque-Zeichenfolge, die in der Anforderung angegeben wird.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern:
.+
- Encrypted
-
Ein boolescher Wert, der mit True anzeigt, dass das Dateisystem verschlüsselt ist.
Typ: Boolesch
- FileSystemArn
-
Der Amazon-Ressourcenname (ARN) für das EFS-Dateisystem, im Format
arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id
. Beispiel mit Beispieldaten:arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567
Typ: Zeichenfolge
- FileSystemId
-
Die von Amazon EFS zugewiesene ID des Dateisystems.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
- FileSystemProtection
-
Gibt den Schutz des Dateisystems an.
Typ: FileSystemProtectionDescription Objekt
- KmsKeyId
-
Die ID eines, das zum Schutz des verschlüsselten Dateisystems AWS KMS key verwendet wird.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen.
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
-
Die Lebenszyklusphase des Dateisystems.
Typ: Zeichenfolge
Zulässige Werte:
creating | available | updating | deleting | deleted | error
- Name
-
Sie können einem Dateisystem Tags hinzufügen, einschließlich eines
Name
-Tags. Weitere Informationen finden Sie unter CreateFileSystem. Wenn das Dateisystem über einName
-Tag verfügt, gibt Amazon EFS den Wert in diesem Feld zurück.Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$
- NumberOfMountTargets
-
Die aktuelle Anzahl von Mounting-Zielen, die das Dateisystem aufweist. Weitere Informationen finden Sie unter CreateMountTarget.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0.
- OwnerId
-
AWS-Konto Derjenige, der das Dateisystem erstellt hat.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 14 Zeichen.
Pattern:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- PerformanceMode
-
Der Leistungsmodus des Dateisystems.
Typ: Zeichenfolge
Zulässige Werte:
generalPurpose | maxIO
- ProvisionedThroughputInMibps
-
Die Menge des bereitgestellten Durchsatzes, gemessen in MiBps, für das Dateisystem. Gültig für Dateisysteme, bei denen
ThroughputMode
aufprovisioned
eingestellt ist.Type: Double
Gültiger Bereich: Mindestwert 1.0.
- SizeInBytes
-
Die letzte bekannte gemessene Größe (in Bytes) der im Dateisystem gespeicherten Daten im Feld
Value
und die Zeit, zu der diese Größe ermittelt wurde, im FeldTimestamp
. Der WertTimestamp
ist die ganzzahlige Anzahl der Sekunden seit 1970-01-01T00:00:00Z. Der WertSizeInBytes
steht nicht für die Größe eines konsistenten Snapshots des Dateisystems, ist aber letztlich konsistent, wenn keine Schreibvorgänge im Dateisystem vorgenommen werden. Das heißt,SizeInBytes
steht nur dann für die tatsächliche Größe, wenn das Dateisystem länger als einige Stunden nicht verändert wurde. Andernfalls entspricht der Wert nicht exakt der Größe, die das Dateisystem zu einem beliebigen Zeitpunkt hatte.Typ: FileSystemSize Objekt
- Tags
-
Die Tags, die dem Dateisystem zugeordnet sind, dargestellt als ein Array von
Tag
-Objekten.Typ: Array von Tag-Objekten
- ThroughputMode
-
Zeigt den Durchsatzmodus des Dateisystems an. Weitere Informationen finden Sie unter Durchsatzmodi im Amazon-EFS-Benutzerhandbuch.
Typ: Zeichenfolge
Zulässige Werte:
bursting | provisioned | elastic
Fehler
- BadRequest
-
Wird zurückgegeben, wenn die Anfrage fehlerhaft ist oder einen Fehler enthält, z. B. einen ungültigen Parameterwert oder einen fehlenden erforderlichen Parameter.
HTTP Status Code: 400
- FileSystemNotFound
-
Wird zurückgegeben, wenn der angegebene
FileSystemId
Wert im Wert des Anforderers nicht vorhanden ist. AWS-KontoHTTP Status Code: 404
- IncorrectFileSystemLifeCycleState
-
Wird zurückgegeben, wenn der Lebenszyklusstatus des Dateisystems nicht „verfügbar“ ist.
HTTP-Statuscode: 409
- InsufficientThroughputCapacity
-
Wird zurückgegeben, wenn die Kapazität nicht ausreicht, um zusätzlichen Durchsatz bereitzustellen. Dieser Wert kann zurückgegeben werden, wenn Sie versuchen, ein Dateisystem im Modus „Bereitgestellter Durchsatz“ zu erstellen, wenn Sie versuchen, den bereitgestellten Durchsatz eines vorhandenen Dateisystems zu erhöhen oder wenn Sie versuchen, ein vorhandenes Dateisystem vom Modus „Bursting Throughput“ auf „Bereitgestellter Durchsatz“ umzustellen. Bitte versuchen Sie es später erneut.
HTTP Status Code: 503
- InternalServerError
-
Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist.
HTTP Status Code: 500
- ThroughputLimitExceeded
-
Wird zurückgegeben, wenn der Durchsatzmodus oder die Menge des bereitgestellten Durchsatzes nicht geändert werden können, da die Durchsatzgrenze von 1 024 Mbit/s erreicht wurde.
HTTP Status Code: 400
- TooManyRequests
-
Wird zurückgegeben, wenn Sie nicht mindestens 24 Stunden warten, bevor Sie entweder den Durchsatzmodus ändern oder den Wert für den bereitgestellten Durchsatz verringern.
HTTP-Statuscode: 429
Weitere Informationen finden Sie auch unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: