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 suspectez un accès non autorisé à un serveur, vous pouvez interrompre tous les transferts actifs et bloquer les nouvelles connexions en arrêtant le serveur. Autre exemple : vous pouvez réduire les coûts de temps d'activité du serveur en le mettant en pause 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 requise 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 événements suivants se produisent :
L'accès est refusé et les connexions actives sont supprimées. 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 closedAucune 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 du projet Google Cloud du serveur.
- LOCATION_ID : emplacementGoogle Cloud du serveur, 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 :
La réponse identifie une opération de longue durée.Bibliothèques clientes
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage C#.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Go.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Java.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Node.js.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage PHP.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Python.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Ruby.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
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 du projet Google Cloud du serveur.
- LOCATION_ID : Google Cloud emplacement du serveur, 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 :
La réponse identifie une opération de longue durée. Le démarrage du serveur prend quelques minutes.Bibliothèques clientes
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage C#.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Go.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Java.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Node.js.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage PHP.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Python.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Cloud FTP, consultez Bibliothèques clientes Cloud FTP. Pour en savoir plus, consultez la documentation de référence de l'API Cloud FTP en langage Ruby.
Pour vous authentifier auprès de Cloud FTP, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.