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. # DescribeFileSystems Gibt die Beschreibung eines bestimmten Amazon-EFS-Dateisystems zurück, wenn entweder das Dateisystem `CreationToken` oder die `FileSystemId` angegeben ist. Andernfalls gibt es Beschreibungen aller Dateisysteme zurück, die dem Aufrufer gehören, AWS-Konto auf dem AWS-Region Endpunkt, den Sie aufrufen. Beim Abrufen aller Dateisystembeschreibungen können Sie optional den Parameter `MaxItems` angeben, um die Anzahl der Beschreibungen in einer Antwort zu begrenzen. Diese Zahl wird automatisch auf 100 gesetzt. Wenn weitere Dateisystembeschreibungen übrig bleiben, gibt Amazon EFS in der Antwort einen `NextMarker`, ein Opaque-Token, zurück. In diesem Fall sollten Sie eine nachfolgende Anforderung senden, bei der der Anforderungsparameter `Marker` auf den Wert `NextMarker` gesetzt ist. Um eine Liste der Dateisystembeschreibungen abzurufen, wird diese Operation in einem iterativen Prozess verwendet, wobei `DescribeFileSystems` zuerst ohne den `Marker` und dann von der Operation so lange aufgerufen wird, bis die Antwort keine `NextMarker` mehr aufweist, wobei der Parameter `Marker` auf den Wert `NextMarker` aus der vorherigen Antwort gesetzt ist. Die Reihenfolge der Dateisysteme, die in der Antwort auf einen `DescribeFileSystems`- Aufruf zurückgegeben werden, und die Reihenfolge der Dateisysteme, die in den Antworten einer Iteration mit mehreren Aufrufen zurückgegeben werden, ist nicht angegeben. Diese Operation erfordert Berechtigungen für die Aktion `elasticfilesystem:DescribeFileSystems`. ## Anforderungssyntax ``` GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI-Anfrageparameter Die Anforderung verwendet die folgenden URI-Parameter. ** [CreationToken](#API_DescribeFileSystems_RequestSyntax) ** (Optional) Beschränkt die Liste auf das Dateisystem mit diesem Erstellungstoken (Zeichenfolge). Ein Erstellungstoken geben Sie bei der Erstellung eines Amazon-EFS-Dateisystems an. Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen. Pattern: `.+` ** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) ** (Optional) ID des Dateisystems, dessen Beschreibung Sie abrufen möchten (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})$` ** [Marker](#API_DescribeFileSystems_RequestSyntax) ** (Optional) Opaque-Paginierungstoken, das von einer vorherigen `DescribeFileSystems`-Operation zurückgegeben wurde (Zeichenfolge). Falls vorhanden, gibt es an, dass die Liste an der Stelle fortgesetzt werden soll, an der der Aufruf, der eine Ausgabe zurückgibt, abgebrochen wurde. Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen. Pattern: `.+` ** [MaxItems](#API_DescribeFileSystems_RequestSyntax) ** (Optional) Gibt die maximale Anzahl der Dateisysteme an, die in der Antwort zurückgegeben werden können (Ganzzahl). Diese Zahl wird automatisch auf 100 gesetzt. Die Antwort wird mit 100 Dateisystemen pro Seite paginiert, sofern es mehr als 100 Dateisysteme gibt. Gültiger Bereich: Mindestwert 1. ## Anforderungstext Der Anforderung besitzt keinen Anforderungstext. ## Antwortsyntax ``` HTTP/1.1 200 Content-type: application/json { "FileSystems": [ { "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" } ], "Marker": "string", "NextMarker": "string" } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) ** Ein Array von Dateisystembeschreibungen. Typ: Array von [FileSystemDescription](API_FileSystemDescription.md)-Objekten ** [Marker](#API_DescribeFileSystems_ResponseSyntax) ** Vorhanden, falls vom Aufrufer in der Anforderung angegeben (Zeichenfolge). Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen. Pattern: `.+` ** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) ** Vorhanden, wenn es mehr Dateisysteme gibt, als in der Antwort zurückgegeben wurden (Zeichenfolge). Sie können `NextMarker` in einer nachfolgenden Anforderung verwenden, um die Beschreibungen abzurufen. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen. Pattern: `.+` ## 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 ** 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 ## Beispiele ### Abrufen einer Liste von 10 Dateisystemen Im folgenden Beispiel wird eine GET-Anfrage an den `file-systems` Endpunkt (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`) gesendet. Die Anforderung gibt einen `MaxItems`-Abfrageparameter an, um die Anzahl der Dateisystembeschreibungen auf 10 zu begrenzen. #### Beispielanforderung ``` GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191208Z Authorization: <...> ``` #### Beispielantwort ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 499 { "FileSystems":[ { "OwnerId":"251839141158", "CreationToken":"MyFileSystem1", "FileSystemId":"fs-01234567", "PerformanceMode" : "generalPurpose", "CreationTime":"1403301078", "LifeCycleState":"created", "Name":"my first file system", "NumberOfMountTargets":1, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 } } ] } ``` ## 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/DescribeFileSystems) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)