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.
TestConnection
Comprueba si el conector SFTP está configurado correctamente. Le recomendamos encarecidamente que realice esta operación para probar su capacidad de transferir archivos entre el AWS almacenamiento local y el servidor SFTP de un socio comercial.
Sintaxis de la solicitud
{
"ConnectorId": "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 formato JSON.
- ConnectorId
-
Un identificador único para el conector.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
c-([0-9a-f]{17})Obligatorio: sí
Sintaxis de la respuesta
{
"ConnectorId": "string",
"Status": "string",
"StatusMessage": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- ConnectorId
-
Devuelve el identificador del objeto conector que está probando.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
c-([0-9a-f]{17}) - Status
-
Devuelve
OKla prueba se ha realizado correctamente oERRORsi la prueba no ha sido satisfactoria.Tipo: cadena
- StatusMessage
-
Devuelve
Connection succeededsi la actualización se realiza correctamente. O bien, devuelve un mensaje de error descriptivo si la prueba no es satisfactoria. En la siguiente lista se proporcionan detalles sobre la solución de problemas, en función del mensaje de error que reciba.-
Compruebe que su nombre secreto coincide con el de los permisos de Transfer Role.
-
Compruebe la URL del servidor en la configuración del conector y compruebe que las credenciales de inicio de sesión funcionan correctamente fuera del conector.
-
Compruebe que el secreto existe y que tiene el formato correcto.
-
Compruebe que la clave de host de confianza de la configuración del conector coincide con la salida de
ssh-keyscan.
Tipo: cadena
-
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.
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
Código de estado HTTP: 400
- ResourceNotFoundException
-
Esta excepción se produce cuando el servicio AWS Transfer Family no encuentra un recurso.
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud ha fallado porque el servicio AWS Transfer Family no está disponible.
Código de estado HTTP: 500
Ejemplos
Ejemplo
El siguiente ejemplo prueba la conexión a un servidor remoto.
aws transfer test-connection --connector-id c-abcd1234567890fff
Respuesta de ejemplo
Si se realiza correctamente, la llamada a la API devuelve los siguientes detalles.
{ "Status": "OK", "StatusMessage": "Connection succeeded" }
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
