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

REST

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

Avant d'utiliser l'une des 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.

REST

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

Avant d'utiliser l'une des 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 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.