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.

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.

Fehler

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: