Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
StopServer
Fait passer l'état d'un serveur compatible avec le protocole de transfert de fichiers de à. ONLINE
OFFLINE
Un OFFLINE
serveur ne peut pas accepter et traiter les tâches de transfert de fichiers. Les informations liées à votre serveur, telles que les propriétés du serveur et de l'utilisateur, ne sont pas affectées par l'arrêt de votre serveur.
Note
L'arrêt du serveur ne réduit ni n'a d'impact sur la facturation de votre terminal de protocole de transfert de fichiers ; vous devez supprimer le serveur pour ne plus être facturé.
L'état de STOPPING
indique que le serveur est dans un état intermédiaire, qu'il n'est pas totalement en mesure de répondre ou qu'il n'est pas complètement hors ligne. Les valeurs de STOP_FAILED
peuvent indiquer une condition d'erreur.
Aucune réponse n'est renvoyée suite à cet appel.
Syntaxe de la requête
{
"ServerId": "string
"
}
Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- ServerId
-
Identifiant unique attribué par le système à un serveur que vous avez arrêté.
Type : chaîne
Contraintes de longueur : longueur fixe de 19.
Modèle :
s-([0-9a-f]{17})
Obligatoire : oui
Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InternalServiceError
-
Cette exception est levée lorsqu'une erreur se produit dans le AWS Transfer Family service.
Code d’état HTTP : 500
- InvalidRequestException
-
Cette exception est levée lorsque le client soumet une demande mal formée.
Code d’état HTTP : 400
- ResourceNotFoundException
-
Cette exception est levée lorsqu'aucune ressource n'est trouvée par le service AWS Transfer Family.
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué car le service AWS Transfer Family n'est pas disponible.
Code d’état HTTP : 500
- ThrottlingException
-
La demande a été refusée suite à une limitation des demandes.
Code d’état HTTP : 400
Exemples
Exemple
L'exemple suivant arrête un serveur.
Exemple de demande
{
"ServerId": "s-01234567890abcdef"
}
Exemple
Il s'agit d'un exemple de réponse pour cet appel d'API.
Exemple de réponse
{
"ServerId": "s-01234567890abcdef"
}
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :