Démarrer ou arrêter un serveur SFTP

Vous pouvez arrêter ou démarrer un serveur SFTP pour gérer son état, contrôler l'accès et optimiser les coûts.

L'arrêt d'un serveur désactive l'accès et réduit l'utilisation des ressources. Par exemple, si vous soupçonnez un accès non autorisé à un serveur, vous pouvez arrêter tous les transferts actifs et bloquer les nouvelles connexions en arrêtant le serveur. Par exemple, vous pouvez réduire les coûts de disponibilité du serveur en le mettant en veille pendant les périodes où aucun transfert de données n'est prévu.

Lorsque vous démarrez un serveur, l'accès est rétabli et les utilisateurs peuvent s'y connecter.

Rôles requis

Pour obtenir l'autorisation nécessaire pour démarrer ou arrêter un serveur SFTP, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Cloud FTP (roles/ftp.admin) 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 l'autorisation ftp.servers.update, qui est nécessaire pour démarrer ou arrêter un serveur SFTP.

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

Arrêter un serveur

Lorsque vous arrêtez un serveur, les opérations suivantes se produisent :

• L'accès est refusé et les connexions actives sont interrompues. Les utilisateurs disposant d'une connexion active peuvent voir un message d'erreur semblable à celui-ci :

  Connection is terminated: Connection closed by remote host
  client_loop: send disconnect: Broken pipe
  Connection closed
  

• Aucune nouvelle connexion ne peut être établie.

Pour arrêter un serveur, procédez comme suit.

REST

Pour arrêter un serveur, utilisez la méthode servers.stop.

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

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

Méthode HTTP et URL :

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

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 POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:stop"

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 POST `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:stop" | Select-Object -Expand Content

La réponse identifie une opération de longue durée.

Démarrer un serveur

REST

Pour démarrer un serveur, utilisez la méthode servers.start.

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

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

Méthode HTTP et URL :

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

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 POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:start"

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 POST `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:start" | Select-Object -Expand Content

La réponse identifie une opération de longue durée. Le démarrage du serveur prend quelques minutes.

Étapes suivantes

• Supprimer des utilisateurs d'un serveur SFTP
• Supprimer un serveur SFTP