SFTP-Nutzerinformationen abrufen

In diesem Dokument wird beschrieben, wie Sie Informationen zu Ihren Cloud FTP-Nutzern abrufen. Sie können alle Nutzer für einen Server auflisten. Außerdem können Sie detaillierte Informationen zu einem bestimmten Nutzer abrufen, z. B. die Verzeichniszuordnungen und Berechtigungen des Nutzers in Cloud Storage.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen in Ihrem Projekt die IAM-Rolle Cloud FTP-Betrachter (roles/ftp.viewer) zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Abrufen von Informationen zu SFTP-Nutzern benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Abrufen von Informationen zu SFTP-Nutzern erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen , um die notwendigen Berechtigungen anzuzeigen, die erforderlich sind:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Informationen zu SFTP-Nutzern abzurufen:

• Nutzer auflisten: ftp.users.list
• Nutzerdetails abrufen: ftp.users.get

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Nutzer auflisten

gcloud

Führen Sie den gcloud alpha storage ftp users list Befehl aus, um die SFTP-Nutzer für einen Server aufzulisten.

Ersetzen Sie vor der Verwendung der Befehlsdaten die folgenden Platzhalter:

• LOCATION_ID: Der Standort des Servers, z. B. us-west1.
• SERVER_ID: Die Server-ID.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

REST

Verwenden Sie die servers.users.list Methode, um die SFTP-Nutzer für einen Server aufzulisten.

Ersetzen Sie vor der Verwendung der Anfragedaten, die folgenden Platzhalter:

• PROJECT_ID: die Google Cloud Projekt-ID.
• LOCATION_ID: Der Standort des Servers, z. B. us-west1.
• SERVER_ID: Die Server-ID.

HTTP-Methode und URL:

GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users" | Select-Object -Expand Content

Der Antworttext ist ein JSON-Objekt mit einer Liste von User Ressourcen.

Details zu einem Nutzer abrufen

Führen Sie die folgenden Schritte aus, um detaillierte Informationen zu einem bestimmten Nutzer abzurufen, z. B. die Verzeichniszuordnungen und Berechtigungen des Nutzers in Cloud Storage, die E-Mail-Adresse des Dienstkontos, das im Namen des Nutzers auf Cloud Storage-Ressourcen zugreift, und die Anmeldedaten des Nutzers.

gcloud

Führen Sie den gcloud alpha storage ftp users describe Befehl aus, um Details zu einem SFTP-Nutzer abzurufen.

Ersetzen Sie vor der Verwendung der Befehlsdaten die folgenden Platzhalter:

• USERNAME: Der Nutzername des SFTP-Nutzers.
• LOCATION_ID: Der Standort des Servers, z. B. us-west1.
• SERVER_ID: Die SFTP-Server-ID.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID \
    --server=SERVER_ID

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID `
    --server=SERVER_ID

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID ^
    --server=SERVER_ID

REST

Verwenden Sie die servers.users.get Methode, um Details zu einem SFTP-Nutzer abzurufen.

Ersetzen Sie vor der Verwendung der Anfragedaten, die folgenden Platzhalter:

• PROJECT_ID: die Google Cloud Projekt-ID.
• LOCATION_ID: Der Standort des Servers, z. B. us-west1.
• SERVER_ID: Die SFTP-Server-ID.
• USERNAME: Der Nutzername des SFTP-Nutzers.

HTTP-Methode und URL:

GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users/USERNAME

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users/USERNAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users/USERNAME" | Select-Object -Expand Content

Der Antworttext ist eine User Ressource.