Obtenir des informations sur les utilisateurs SFTP

Ce document explique comment obtenir des informations sur vos utilisateurs Cloud FTP. Vous pouvez répertorier tous les utilisateurs d'un serveur. Vous pouvez également obtenir des informations détaillées sur un utilisateur spécifique, telles que les mappages et les autorisations de répertoire Cloud Storage de l'utilisateur.

Rôles requis

Pour obtenir les autorisations nécessaires pour obtenir des informations sur les utilisateurs SFTP, demandez à votre administrateur de vous accorder le rôle IAM de lecteur Cloud FTP (roles/ftp.viewer) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour obtenir des informations sur les utilisateurs SFTP. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour obtenir des informations sur les utilisateurs SFTP :

• Répertorier les utilisateurs : ftp.users.list
• Obtenir les détails de l'utilisateur : ftp.users.get

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Répertorier les utilisateurs

gcloud

Pour répertorier les utilisateurs SFTP d'un serveur, exécutez la gcloud alpha storage ftp users list commande.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• LOCATION_ID : emplacement du serveur, tel que us-west1.
• SERVER_ID : ID du serveur.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

REST

Pour répertorier les utilisateurs SFTP d'un serveur, utilisez la servers.users.list méthode.

Avant d'utiliser les données de la requête, effectuez les remplacements suivants :

• PROJECT_ID : ID du Google Cloud projet.
• LOCATION_ID : emplacement du serveur, tel que us-west1.
• SERVER_ID : ID du serveur.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Le corps de la réponse est un objet JSON contenant une liste de User ressources.

Obtenir des informations sur un utilisateur

Pour obtenir des informations détaillées sur un utilisateur spécifique, telles que les mappages et les autorisations de répertoire Cloud Storage de l'utilisateur, l'adresse e-mail du compte de service qui accède aux ressources Cloud Storage au nom de l'utilisateur et les identifiants de l'utilisateur, procédez comme suit.

gcloud

Pour obtenir des informations sur un utilisateur SFTP, exécutez la gcloud alpha storage ftp users describe commande.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• USERNAME : nom d'utilisateur SFTP.
• LOCATION_ID : l'emplacement du serveur, tel que us-west1.
• SERVER_ID : ID du serveur SFTP.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

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

REST

Pour obtenir des informations sur un utilisateur SFTP, utilisez la servers.users.get méthode.

Avant d'utiliser les données de la requête, effectuez les remplacements suivants :

• PROJECT_ID : ID du Google Cloud projet.
• LOCATION_ID : l'emplacement du serveur, tel que us-west1.
• SERVER_ID : ID du serveur SFTP.
• USERNAME : nom d'utilisateur SFTP.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Le corps de la réponse est une User ressource.