Transfer / Client / test_connection
test_connection#
- Transfer.Client.test_connection(**kwargs)#
Tests whether your SFTP connector is set up successfully. We highly recommend that you call this operation to test your ability to transfer files between local Amazon Web Services storage and a trading partner’s SFTP server.
See also: AWS API Documentation
Request Syntax
response = client.test_connection( ConnectorId='string' )
- Parameters:
ConnectorId (string) –
[REQUIRED]
The unique identifier for the connector.
- Return type:
dict
- Returns:
Response Syntax
{ 'ConnectorId': 'string', 'Status': 'string', 'StatusMessage': 'string' }
Response Structure
(dict) –
ConnectorId (string) –
Returns the identifier of the connector object that you are testing.
Status (string) –
Returns
OK
for successful test, orERROR
if the test fails.StatusMessage (string) –
Returns
Connection succeeded
if the test is successful. Or, returns a descriptive error message if the test fails. The following list provides troubleshooting details, depending on the error message that you receive.Verify that your secret name aligns with the one in Transfer Role permissions.
Verify the server URL in the connector configuration , and verify that the login credentials work successfully outside of the connector.
Verify that the secret exists and is formatted correctly.
Verify that the trusted host key in the connector configuration matches the
ssh-keyscan
output.
Exceptions
Transfer.Client.exceptions.ResourceNotFoundException
Transfer.Client.exceptions.InvalidRequestException
Transfer.Client.exceptions.InternalServiceError
Transfer.Client.exceptions.ServiceUnavailableException