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.
Der entsprechende CLI-Befehl lautetdescribe-mount-targets.
Anforderungssyntax
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
URI-Anfrageparameter
Die Anforderung 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
FileSystemIdoderMountTargetIdin der Anforderung enthalten ist. Akzeptiert entweder eine Zugangspunkt-ID oder einen 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
AccessPointIdoderMountTargetIdin der Anforderung enthalten ist. Akzeptiert entweder eine Dateisystem-ID oder einen 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
FileSystemIdin der Anforderung enthalten ist. Akzeptiert entweder eine Mountingziel-ID oder einen ARN als Eingabe.Längenbeschränkungen: Mindestlänge von 13. 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",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "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.
- Marker
-
Wenn die Anforderung den
Markerenthä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
Markerangeben, 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
AccessPointIdWert 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 Status Code: 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.
- 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: 400
- FileSystemNotFound
-
Wird zurückgegeben, wenn der angegebene
FileSystemIdWert 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 Status Code: 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
- MountTargetNotFound
-
Wird zurückgegeben, wenn kein Mountingzel mit der angegebenen ID im AWS-Konto des Aufrufers gefunden 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 Status Code: 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 dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
