UpdateFileSystem - Amazon Elastic File System
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie auch unter:

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.

UpdateFileSystem

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 in Mebibyte pro Sekunde (MiBps) gemessene Durchsatz, den Sie für ein Dateisystem bereitstellen möchten, das Sie gerade erstellen. Erforderlich, wenn ThroughputMode auf provisioned 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. AWS 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 in provisioned ändern, müssen Sie auch einen Wert für ProvisionedThroughputInMibps 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-az1Ist beispielsweise eine Availability Zone ID für die US-East-1 AWS-Region, und sie hat in jedem Fall den gleichen Standort. AWS-Konto

Typ: 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 ein Name-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 auf provisioned 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 Feld Timestamp. Der Wert Timestamp ist die ganzzahlige Anzahl der Sekunden seit 1970-01-01T00:00:00Z. Der Wert SizeInBytes 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-Konto

HTTP 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 einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: