DescribeMountTargets - Amazon Elastic File System

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.

DescribeMountTargets

Gibt die Beschreibungen aller aktuellen Mountziele oder eines bestimmten Mountziels für ein Dateisystem zurück Wenn alle aktuellen Mountingziele angefordert werden, ist die Reihenfolge der Mountingziele, die in der Antwort zurückgegeben werden, nicht angegeben.

Für diesen Vorgang sind Berechtigungen für die Aktion elasticfilesystem:DescribeMountTargets erforderlich, entweder für die Dateisystem-ID, die Sie in FileSystemId angeben, oder für das Dateisystem des Mountingziels, das Sie in MountTargetId angeben.

Anforderungssyntax

GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1

URIAnforderungsparameter

Die Anfrage verwendet die folgenden URI Parameter.

AccessPointId

(Optional) Die ID des Zugangspunkts, dessen Mountingziele Sie auflisten möchten. Sie muss in der Anforderung enthalten sein, falls keine FileSystemId oder MountTargetId in der Anforderung enthalten ist. Akzeptiert entweder eine Zugriffspunkt-ID oder ARN als Eingabe.

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

Pattern: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

FileSystemId

(Optional) ID des Dateisystems, dessen Mountingziele Sie auflisten möchten (Zeichenfolge). Sie muss in der Anforderung enthalten sein, falls keine AccessPointId oder MountTargetId in der Anforderung enthalten ist. Akzeptiert entweder eine Dateisystem-ID oder ARN als Eingabe.

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

(Optional) Opaque-Paginierungstoken, das von einer vorherigen DescribeMountTargets-Operation zurückgegeben wurde (Zeichenfolge). Falls vorhanden, gibt es an, dass die Liste an der Stelle fortgesetzt werden soll, an der der vorherige 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

(Optional) Die maximale Anzahl der Mountingziele, die in der Antwort zurückgegeben werden können. Derzeit wird diese Anzahl automatisch auf 10 gesetzt, und andere Werte werden ignoriert. Die Antwort wird mit 100 Mountingzielen pro Seite paginiert, sofern es mehr als 100 Mountingziele gibt.

Gültiger Bereich: Mindestwert 1.

MountTargetId

(Optional) ID des Mountingziels, das beschrieben werden soll (Zeichenfolge). Sie muss in der Anforderung enthalten sein, falls keine FileSystemId in der Anforderung enthalten ist. Akzeptiert entweder eine Mount-Ziel-ID oder ARN als Eingabe.

Längenbeschränkungen: Minimale Länge beträgt 13 Zeichen. Maximale Länge beträgt 45 Zeichen.

Pattern: ^fsmt-[0-9a-f]{8,40}$

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 200 Content-type: application/json { "Marker": "string", "MountTargets": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "string" } ], "NextMarker": "string" }

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

Marker

Wenn die Anforderung den Marker enthält, wird dieser Wert in der Antwort in diesem Feld zurückgegeben.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: .+

MountTargets

Gibt die Mountingziele des Dateisystems als Array von MountTargetDescription-Objekten zurück.

Typ: Array von MountTargetDescription-Objekten

NextMarker

Wenn ein Wert vorhanden ist, sind weitere Mountingziele verfügbar, die zurückgegeben werden. In einer nachfolgenden Anforderung können Sie Marker angeben, um den nächsten Satz von Mountingzielen abzurufen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: .+

Fehler

AccessPointNotFound

Wird zurückgegeben, wenn der angegebene AccessPointId Wert im Wert des Anforderers nicht vorhanden ist AWS-Konto.

HTTPStatuscode: 404

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.

HTTPStatuscode: 400

FileSystemNotFound

Wird zurückgegeben, wenn der angegebene FileSystemId Wert im Wert des Anforderers nicht vorhanden ist AWS-Konto.

HTTPStatuscode: 404

InternalServerError

Wird zurückgegeben, wenn auf der Serverseite ein Fehler aufgetreten ist.

HTTPStatuscode: 500

MountTargetNotFound

Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden wurde.

HTTPStatuscode: 404

Beispiele

Abrufen von Beschreibungen von Mountingzielen, die für ein Dateisystem erstellt wurden

Die folgende Anforderung ruft Beschreibungen von Mountingzielen ab, die für das angegebene Dateisystem erstellt wurden.

Beispielanforderung

GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191252Z Authorization: <...>

Beispielantwort

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 357 { "MountTargets":[ { "OwnerId":"251839141158", "MountTargetId":"fsmt-01234567", "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "LifeCycleState":"added", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" } ] }

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: