ListAccesses - AWS Transfer Family
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

ListAccesses

Listet die Details für alle Zugriffe auf, die Sie auf Ihrem Server haben.

Anforderungssyntax

{
   "MaxResults": number,
   "NextToken": "string",
   "ServerId": "string"
}

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

MaxResults

Gibt die maximale Anzahl der zurückzugebenden Zugriffs-SIDs an.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.

Erforderlich: Nein

NextToken

Wenn Sie mit dem ListAccesses Aufruf zusätzliche Ergebnisse erzielen können, wird in der Ausgabe ein NextToken Parameter zurückgegeben. Sie können dann einen nachfolgenden Befehl an den NextToken Parameter übergeben, um weitere Zugriffe aufzulisten.

Typ: Zeichenfolge

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

Erforderlich: Nein

ServerId

Ein vom System zugewiesener eindeutiger Bezeichner für einen Server, dem Benutzer zugewiesen sind.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von 19.

Pattern: s-([0-9a-f]{17})

Erforderlich: Ja

Antwortsyntax

{
   "Accesses": [ 
      { 
         "ExternalId": "string",
         "HomeDirectory": "string",
         "HomeDirectoryType": "string",
         "Role": "string"
      }
   ],
   "NextToken": "string",
   "ServerId": "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.

Accesses

Gibt die Zugriffe und ihre Eigenschaften für den von Ihnen angegebenen ServerId Wert zurück.

Typ: Array von ListedAccess-Objekten

NextToken

Wenn Sie mit dem ListAccesses Aufruf zusätzliche Ergebnisse erzielen können, wird in der Ausgabe ein NextToken Parameter zurückgegeben. Sie können dann einen nachfolgenden Befehl an den NextToken Parameter übergeben, um weitere Zugriffe aufzulisten.

Typ: Zeichenfolge

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

ServerId

Ein vom System zugewiesener eindeutiger Bezeichner für einen Server, dem Benutzer zugewiesen sind.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von 19.

Pattern: s-([0-9a-f]{17})

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InternalServiceError

Diese Ausnahme wird ausgelöst, wenn im AWS Transfer Family Dienst ein Fehler auftritt.

HTTP Status Code: 500

InvalidNextTokenException

Der übergebene NextToken Parameter ist ungültig.

HTTP Status Code: 400

InvalidRequestException

Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet.

HTTP Status Code: 400

ResourceNotFoundException

Diese Ausnahme wird ausgelöst, wenn eine Ressource vom AWS Transfer Family Family-Dienst nicht gefunden wird.

HTTP Status Code: 400

ServiceUnavailableException

Die Anfrage ist fehlgeschlagen, da der AWS Transfer Family Family-Dienst nicht verfügbar ist.

HTTP Status Code: 500

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: