DescribeAccess - 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.

DescribeAccess

Beschreibt den Zugriff, der dem spezifischen Server mit aktiviertem Dateiübertragungsprotokoll zugewiesen ist, wie er durch seine ServerId Eigenschaft und seine identifiziert wird. ExternalId

Die Antwort auf diesen Aufruf gibt die Eigenschaften des Zugriffs zurück, der dem angegebenen ServerId Wert zugeordnet ist.

Anforderungssyntax

{
   "ExternalId": "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.

ExternalId

Eine eindeutige Kennung, die zur Identifizierung bestimmter Gruppen in Ihrem Verzeichnis erforderlich ist. Die Benutzer der Gruppe, die Sie zuordnen, haben über die aktivierten Protokolle Zugriff auf Ihre Amazon S3- oder EFS Amazon-Ressourcen AWS Transfer Family. Wenn Sie den Gruppennamen kennen, können Sie die SID Werte anzeigen, indem Sie den folgenden Befehl unter Windows ausführen PowerShell.

Get-ADGroup -Filter {samAccountName -like "YourGroupName*"} -Properties * | Select SamAccountName,ObjectSid

Ersetzen Sie diesen Befehl YourGroupNamedurch den Namen Ihrer Active Directory-Gruppe.

Der reguläre Ausdruck, der zur Überprüfung dieses Parameters verwendet wird, ist eine Zeichenfolge, die aus alphanumerischen Groß- und Kleinbuchstaben ohne Leerzeichen besteht. Sie können auch Unterstriche oder eines der folgenden Zeichen verwenden: =, . @: /-

Typ: Zeichenfolge

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

Pattern: S-1-[\d-]+

Erforderlich: Ja

ServerId

Ein vom System zugewiesener eindeutiger Bezeichner für einen Server, dem dieser Zugriff zugewiesen wurde.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

Antwortsyntax

{
   "Access": { 
      "ExternalId": "string",
      "HomeDirectory": "string",
      "HomeDirectoryMappings": [ 
         { 
            "Entry": "string",
            "Target": "string",
            "Type": "string"
         }
      ],
      "HomeDirectoryType": "string",
      "Policy": "string",
      "PosixProfile": { 
         "Gid": number,
         "SecondaryGids": [ number ],
         "Uid": number
      },
      "Role": "string"
   },
   "ServerId": "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.

Access

Die externe Kennung des Servers, mit dem der Zugriff verbunden ist.

Typ: DescribedAccess Objekt

ServerId

Eine vom System zugewiesene eindeutige Kennung für einen Server, dem dieser Zugriff zugewiesen wurde.

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.

HTTPStatuscode: 500

InvalidRequestException

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

HTTPStatuscode: 400

ResourceNotFoundException

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

HTTPStatuscode: 400

ServiceUnavailableException

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

HTTPStatuscode: 500

Weitere Informationen finden Sie unter:

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