DescribedUser

Beschreibt die Eigenschaften eines angegebenen Benutzers.

Inhalt

Arn

Gibt den eindeutigen Amazon-Ressourcennamen (ARN) für den Benutzer an, dessen Beschreibung angefordert wurde.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 1600 Zeichen.

Pattern: arn:\S+

Erforderlich: Ja

HomeDirectory

Das Zielverzeichnis (Ordner) für einen Benutzer bei der Serveranmeldung mithilfe des Client.

Ein Beispiel für HomeDirectory ist /bucket_name/home/mydirectory.

Anmerkung

Der HomeDirectory-Parameter wird nur verwendet, wenn HomeDirectoryType auf PATH gesetzt ist.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 1024 Zeichen.

Pattern: (|/.*)

Erforderlich: Nein

HomeDirectoryMappings

Logische Verzeichniszuordnungen, die angeben, welche Amazon S3- oder Amazon EFS-Pfade und -Schlüssel für Ihren Benutzer sichtbar sein sollen und wie Sie sie sichtbar machen möchten. Sie müssen das Entry Target Und-Paar angeben, das Entry zeigt, wie der Pfad sichtbar gemacht Target wird und der tatsächliche Amazon S3- oder Amazon EFS-Pfad ist. Wenn Sie nur ein Ziel angeben, wird es unverändert angezeigt. Sie müssen außerdem sicherstellen, dass Ihre AWS Identity and Access Management (IAM-) Rolle Zugriff auf Pfade in Target bietet. Dieser Wert kann nur gesetzt werden, wenn er auf LOGICAL gesetzt HomeDirectoryType ist.

In den meisten Fällen können Sie diesen Wert anstelle der Sitzungsrichtlinie verwenden, um Ihren Benutzer auf das angegebene Home-Verzeichnis (“ chroot „) zu beschränken. Dazu können Sie den Wert Entry auf '/' und dann Target auf den HomeDirectory Parameterwert setzen.

Typ: Array von HomeDirectoryMapEntry-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 50000 Elementen.

Erforderlich: Nein

HomeDirectoryType

Die Art des Zielverzeichnisses (Ordners), das das Home-Verzeichnis Ihrer Benutzer sein soll, wenn sie sich beim Server anmelden. Wenn Sie es auf einstellenPATH, sieht der Benutzer den absoluten Amazon S3-Bucket- oder Amazon EFS-Pfad so, wie er in seinen File Transfer Protocol-Clients ist. Wenn Sie es auf einstellenLOGICAL, müssen Sie Zuordnungen dafür angeben, wie Sie Amazon S3- oder Amazon EFS-Pfade HomeDirectoryMappings für Ihre Benutzer sichtbar machen möchten.

Anmerkung

HomeDirectoryTypeIst dies der LOGICAL Fall, müssen Sie mithilfe des Parameters Zuordnungen angeben. HomeDirectoryMappings Ist dies hingegen der Fall, HomeDirectoryType geben Sie mithilfe des Parameters einen absoluten Pfad anHomeDirectory. PATH Sie können nicht beides HomeDirectory und HomeDirectoryMappings in Ihrer Vorlage haben.

Typ: Zeichenfolge

Zulässige Werte: PATH | LOGICAL

Erforderlich: Nein

Policy

Eine Sitzungsrichtlinie für Ihren Benutzer, sodass Sie dieselbe AWS Identity and Access Management (IAM-) Rolle für mehrere Benutzer verwenden können. Diese Richtlinie beschränkt den Zugriff eines Benutzers auf Teile seines Amazon S3 S3-Buckets. Variablen, die Sie in dieser Richtlinie verwenden können: ${Transfer:UserName}, ${Transfer:HomeDirectory} und ${Transfer:HomeBucket}.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Nein

PosixProfile

Gibt die vollständige POSIX-Identität an, einschließlich Benutzer-ID (Uid), Gruppen-ID (Gid) und sekundärer Gruppen-IDs (SecondaryGids), die den Zugriff Ihrer Benutzer auf Ihre Amazon Elastic File System (Amazon EFS)-Dateisysteme steuert. Die POSIX-Berechtigungen, die für Dateien und Verzeichnisse in Ihrem Dateisystem festgelegt sind, bestimmen die Zugriffsebene, die Ihre Benutzer beim Übertragen von Dateien in und aus Ihren Amazon EFS-Dateisystemen erhalten.

Typ: PosixProfile Objekt

Erforderlich: Nein

Role

Der Amazon-Ressourcenname (ARN) der Rolle AWS Identity and Access Management (IAM), die den Zugriff Ihrer Benutzer auf Ihren Amazon S3-Bucket oder Ihr Amazon EFS-Dateisystem steuert. Die mit dieser Rolle verbundenen Richtlinien bestimmen die Zugriffsebene, die Sie Ihren Benutzern beim Übertragen von Dateien in und aus Ihrem Amazon-S3-Bucket oder Amazon-EFS-Dateisystem bereitstellen möchten. Die IAM-Rolle sollte außerdem eine Vertrauensstellung enthalten, mit der der Server Zugriff auf Ihre Ressourcen erhält, wenn er die Übertragungsanfragen Ihres Benutzers bearbeitet.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 2048 Zeichen.

Pattern: arn:.*role/\S+

Erforderlich: Nein

SshPublicKeys

Gibt den öffentlichen Schlüsselteil der für den beschriebenen Benutzer gespeicherten Secure Shell (SSH)-Schlüssel an.

Typ: Array von SshPublicKey-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 5 Elemente.

Erforderlich: Nein

Tags

Gibt die Schlüssel-Wert-Paare für den angeforderten Benutzer an. Tag kann für eine Vielzahl von Zwecken verwendet werden, um nach Benutzern zu suchen und diese zu gruppieren.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.

Erforderlich: Nein

UserName

Gibt den Namen des Benutzers an, dessen Beschreibung angefordert wurde. Benutzernamen werden zu Authentifizierungszwecken verwendet. Dies ist die Zeichenfolge, die von Ihrem Benutzer verwendet wird, wenn er sich bei Ihrem Server anmeldet.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 100 Zeichen.

Pattern: [\w][\w@.-]{2,99}

Erforderlich: Nein

Weitere Informationen finden Sie unter:

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

• AWS SDK for C++

• AWS SDK for Java V2

• AWS SDK for Ruby V3