Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
StopServer
Cambia el estado de un servidor habilitado para el protocolo de File Transfer de ONLINE a OFFLINE. Un servidor OFFLINE no puede aceptar ni procesar trabajos de File Transfer. La información vinculada a su servidor, así como las propiedades del servidor y del usuario, no se ven afectadas por la detención del servidor.
nota
Detener el servidor no reduce ni afecta a la facturación de los puntos de conexión del protocolo de File Transfer: debe eliminar el servidor para dejar de facturarse.
El estado de STOPPING indica que el servidor se encuentra en un estado intermedio; es decir, que no puede responder por completo o que no está completamente desconectado. Los valores de STOP_FAILED pueden indicar una condición de error.
No se devuelve ninguna respuesta de esta llamada.
Sintaxis de la solicitud
{
"ServerId": "string"
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en JSON formato.
- ServerId
-
Identificador único asignado por el sistema para un servidor que haya detenido.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
s-([0-9a-f]{17})Obligatorio: sí
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200 puntos con HTTP el cuerpo vacío.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InternalServiceError
-
Esta excepción se produce cuando se produce un error en el AWS Transfer Family servicio.
HTTPCódigo de estado: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
Esta excepción se produce cuando el servicio AWS Transfer Family no encuentra un recurso.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud ha fallado porque el servicio AWS Transfer Family no está disponible.
HTTPCódigo de estado: 500
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
HTTPCódigo de estado: 400
Ejemplos
Ejemplo
El siguiente detiene el servicio.
Solicitud de muestra
{
"ServerId": "s-01234567890abcdef"
}Ejemplo
Este es un ejemplo de respuesta para esta API llamada.
Respuesta de ejemplo
{
"ServerId": "s-01234567890abcdef"
}Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
