Obtenir des informations sur le serveur SFTP

Ce document explique comment obtenir des informations sur vos serveurs Cloud FTP. Vous pouvez lister tous les serveurs SFTP d'un projet et d'un emplacement. Vous pouvez également obtenir des informations détaillées sur un serveur spécifique, telles que son état et ses informations de connexion.

Rôles requis

Pour obtenir les autorisations nécessaires pour obtenir des informations sur les serveurs 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 serveurs 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 serveurs SFTP :

• Lister les serveurs : ftp.servers.list
• Obtenir les détails du serveur : ftp.servers.get

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

Lister les serveurs

gcloud

Pour lister les serveurs SFTP, exécutez la gcloud alpha storage ftp servers list commande.

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

• LOCATION_ID : l'emplacement du serveur, par exemple us-west1.

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 servers list --location=LOCATION_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 servers list --location=LOCATION_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 servers list --location=LOCATION_ID

REST

Pour lister les serveurs SFTP, utilisez la servers.list méthode.

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

• PROJECT_ID : ID du Google Cloud projet.
• LOCATION_ID : l'emplacement du serveur, par exemple us-west1.

Méthode HTTP et URL :

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

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"

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" | Select-Object -Expand Content

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

Obtenir des informations sur un serveur

Pour obtenir des informations détaillées sur un serveur spécifique, y compris son adresse IP ou son rattachement de service, son état, ses identifiants et l'adresse e-mail de l'agent de service, procédez comme suit.

gcloud

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

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

• SERVER_ID : ID du serveur SFTP.
• LOCATION_ID : l'emplacement du serveur, par exemple us-west1.

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 servers describe SERVER_ID --location=LOCATION_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 servers describe SERVER_ID --location=LOCATION_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 servers describe SERVER_ID --location=LOCATION_ID

REST

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

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

• PROJECT_ID : ID du Google Cloud projet.
• LOCATION_ID : l'emplacement du serveur, par exemple us-west1.
• SERVER_ID : ID du serveur SFTP.

Méthode HTTP et URL :

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

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"

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" | Select-Object -Expand Content

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