Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
TestConnection
Verifica se il connettore SFTP è configurato correttamente. Ti consigliamo vivamente di chiamare questa operazione per testare la tua capacità di trasferire file tra l' AWS archiviazione locale e il server SFTP di un partner commerciale.
Sintassi della richiesta
{
"ConnectorId": "string
"
}
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- ConnectorId
-
L'identificatore univoco del connettore.
▬Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 19.
Modello:
c-([0-9a-f]{17})
Campo obbligatorio: sì
Sintassi della risposta
{
"ConnectorId": "string",
"Status": "string",
"StatusMessage": "string"
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- ConnectorId
-
Restituisce l'identificatore dell'oggetto connettore che state testando.
▬Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 19.
Modello:
c-([0-9a-f]{17})
- Status
-
Restituisce se
OK
il test ha avuto esito positivo oERROR
se il test ha esito negativo.▬Tipo: stringa
- StatusMessage
-
Restituisce
Connection succeeded
se il test ha esito positivo. In alternativa, restituisce un messaggio di errore descrittivo se il test ha esito negativo. L'elenco seguente fornisce dettagli sulla risoluzione dei problemi, a seconda del messaggio di errore ricevuto.-
Verifica che il tuo nome segreto sia allineato a quello nelle autorizzazioni Transfer Role.
-
Verifica l'URL del server nella configurazione del connettore e verifica che le credenziali di accesso funzionino correttamente all'esterno del connettore.
-
Verifica che il segreto esista e sia formattato correttamente.
-
Verifica che la chiave host affidabile nella configurazione del connettore corrisponda all'
ssh-keyscan
output.
▬Tipo: stringa
-
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalServiceError
-
Questa eccezione viene generata quando si verifica un errore nel AWS Transfer Family servizio.
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.
Codice di stato HTTP: 500
Esempi
Esempio
L'esempio seguente verifica la connessione a un server remoto.
aws transfer test-connection --connector-id c-abcd1234567890fff
Risposta di esempio
In caso di successo, la chiamata API restituisce i seguenti dettagli.
{ "Status": "OK", "StatusMessage": "Connection succeeded" }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: