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](#API_UpdateFileSystem_RequestSyntax) ** 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](#API_UpdateFileSystem_RequestSyntax) ** (Optional) Der Durchsatz, gemessen in Mebibyte pro Sekunde (MiBps), den Sie für ein Dateisystem bereitstellen möchten, das Sie 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. Support Weitere Informationen finden Sie unter [Amazon-EFS-Kontingente, die Sie erhöhen können](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits) im *Amazon-EFS-Benutzerhandbuch*. Type: Double Gültiger Bereich: Mindestwert 1.0. Erforderlich: Nein ** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) ** (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](#API_UpdateFileSystem_ResponseSyntax) ** 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-Konto Typ: Zeichenfolge ** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) ** 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](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) 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](#API_UpdateFileSystem_ResponseSyntax) ** Die Zeit, zu der das Dateisystem erstellt wurde, in Sekunden (seit 1970-01-01T00:00:00Z). Typ: Zeitstempel ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Ein boolescher Wert, der mit True anzeigt, dass das Dateisystem verschlüsselt ist. Typ: Boolescher Wert ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Gibt den Schutz des Dateisystems an. Typ: [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) Objekt ** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Die Lebenszyklusphase des Dateisystems. Typ: Zeichenfolge Zulässige Werte: `creating | available | updating | deleting | deleted | error` ** [Name](#API_UpdateFileSystem_ResponseSyntax) ** Sie können einem Dateisystem Tags hinzufügen, einschließlich eines `Name`-Tags. Weitere Informationen finden Sie unter [CreateFileSystem](API_CreateFileSystem.md). 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](#API_UpdateFileSystem_ResponseSyntax) ** Die aktuelle Anzahl von Mounting-Zielen, die das Dateisystem aufweist. Weitere Informationen finden Sie unter [CreateMountTarget](API_CreateMountTarget.md). Typ: Ganzzahl Gültiger Bereich: Mindestwert 0. ** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** Der Leistungsmodus des Dateisystems. Typ: Zeichenfolge Zulässige Werte: `generalPurpose | maxIO` ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) ** 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](#API_UpdateFileSystem_ResponseSyntax) ** 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](API_FileSystemSize.md) Objekt ** [Tags](#API_UpdateFileSystem_ResponseSyntax) ** Die Tags, die dem Dateisystem zugeordnet sind, dargestellt als ein Array von `Tag`-Objekten. Typ: Array von [Tag](API_Tag.md)-Objekten ** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) ** Zeigt den Durchsatzmodus des Dateisystems an. Weitere Informationen finden Sie unter [Durchsatzmod](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)i 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. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP-Statuscode: 400 ** FileSystemNotFound ** Wird zurückgegeben, wenn der angegebene `FileSystemId` Wert im Wert des Anforderers nicht vorhanden ist. AWS-Konto ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP-Statuscode: 404 ** IncorrectFileSystemLifeCycleState ** Wird zurückgegeben, wenn der Lebenszyklusstatus des Dateisystems nicht „verfügbar“ ist. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. 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. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP Status Code: 503 ** InternalServerError ** Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. 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 1024 erreicht MiB/s wurde. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP-Statuscode: 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. ** ErrorCode ** Der Fehlercode ist eine Zeichenfolge handelt, die eine Fehlerbedingung eindeutig identifiziert. Er ist für Programme vorgesehen, die Fehler dem Typ nach erkennen und verarbeiten. ** Message ** Die Fehlermeldung enthält eine generische Beschreibung der Fehlerbedingung in englischer Sprache. Sie ist für dafür vorgesehen, von Menschen gelesen zu werden. Einfache Programme zeigen dem Endbenutzer die Meldung direkt an, wenn sie auf eine Fehlerbedingung treffen, die sie nicht kennen, oder die sie nicht verarbeiten können. Komplexere Programme mit einer umfangreicheren Fehlerverarbeitung und einer geeigneten Internationalisierung werden die Fehlermeldung eher ignorieren. HTTP-Statuscode: 429 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)