TestConnection - AWS Transfer Family
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriEsempiVedi anche

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 SFTP connettore è configurato correttamente. Ti consigliamo vivamente di chiamare questa operazione per testare la tua capacità di trasferire file tra l' AWS archiviazione locale e il SFTP server 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 nel JSON formato.

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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal 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 o ERROR 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 il server URL 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-keyscanoutput.

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.

HTTPCodice di stato: 500

InvalidRequestException

Questa eccezione viene generata quando il client invia una richiesta non valida.

HTTPCodice di stato: 400

ResourceNotFoundException

Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.

HTTPCodice di stato: 400

ServiceUnavailableException

La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.

HTTPCodice di stato: 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 API chiamata restituisce i seguenti dettagli.

{                                                                                                                                                             
    "Status": "OK",                                                                                                                                           
    "StatusMessage": "Connection succeeded"                                                                                                                   
}

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API opzione in una delle lingue specifiche AWS SDKs, consulta quanto segue: