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à.
StartFileTransfer
Inizia un trasferimento di file tra l' AWS archiviazione locale e un SFTP server remotoAS2.
-
Per un AS2 connettore, specificate
ConnectorIde uno o piùSendFilePathsper identificare i file da trasferire. -
Per un SFTP connettore, il trasferimento di file può essere in uscita o in entrata. In entrambi i casi, si specifica il.
ConnectorIdA seconda della direzione del trasferimento, si specificano anche i seguenti elementi:-
Se trasferisci un file dal SFTP server di un partner allo storage di Amazon Web Services, ne specifichi uno o più
RetreiveFilePathsper identificare i file che desideri trasferire eLocalDirectoryPatha per specificare la cartella di destinazione. -
Se trasferisci un file dal SFTP server di un partner dallo AWS storage, ne specifichi uno o più
SendFilePathsper identificare i file che desideri trasferire eRemoteDirectoryPatha per specificare la cartella di destinazione.
-
Sintassi della richiesta
{
"ConnectorId": "string",
"LocalDirectoryPath": "string",
"RemoteDirectoryPath": "string",
"RetrieveFilePaths": [ "string" ],
"SendFilePaths": [ "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ì
- LocalDirectoryPath
-
Per un trasferimento in entrata,
LocaDirectoryPathspecifica la destinazione per uno o più file trasferiti dal server del partner. SFTPTipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.
Modello:
(.)+Campo obbligatorio: no
- RemoteDirectoryPath
-
Per un trasferimento in uscita,
RemoteDirectoryPathspecifica la destinazione di uno o più file trasferiti al server del partner. SFTP Se non si specifica aRemoteDirectoryPath, la destinazione dei file trasferiti è la home directory SFTP dell'utente.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.
Modello:
(.)+Campo obbligatorio: no
- RetrieveFilePaths
-
Uno o più percorsi di origine per il SFTP server del partner. Ogni stringa rappresenta il percorso del file di origine per un trasferimento di file in entrata.
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.
Modello:
(.)+Campo obbligatorio: no
- SendFilePaths
-
Uno o più percorsi di origine per lo storage Amazon S3. Ogni stringa rappresenta un percorso di file di origine per un trasferimento di file in uscita. Ad esempio
DOC-EXAMPLE-BUCKET/myfile.txt.Nota
DOC-EXAMPLE-BUCKETSostituiscilo con uno dei tuoi bucket effettivi.Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.
Modello:
(.)+Campo obbligatorio: no
Sintassi della risposta
{
"TransferId": "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.
- TransferId
-
Restituisce l'identificatore univoco per il trasferimento del file.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 512 caratteri.
Modello:
[0-9a-zA-Z./-]+
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
- ThrottlingException
-
La richiesta è stata negata a causa del throttling della richiesta.
HTTPCodice di stato: 400
Esempi
Esempio
L'esempio seguente avvia un trasferimento di AS2 file da un server Transfer Family all'endpoint di un partner commerciale remoto.
DOC-EXAMPLE-BUCKET
Sostituiscilo con uno dei tuoi bucket attuali.
Richiesta di esempio
{
"ConnectorId": "c-AAAA1111BBBB2222C",
"SendFilePaths": [
"/DOC-EXAMPLE-BUCKET/myfile-1.txt",
"/DOC-EXAMPLE-BUCKET/myfile-2.txt",
"/DOC-EXAMPLE-BUCKET/myfile-3.txt"
]
}Risposta di esempio
{
"TransferId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}Esempio
L'esempio seguente avvia un trasferimento di file dalla AWS memoria locale a un SFTP server remoto.
Richiesta di esempio
{
"ConnectorId": "c-01234567890abcdef",
"SendFilePaths": [
"/DOC-EXAMPLE-BUCKET/myfile-1.txt",
"/DOC-EXAMPLE-BUCKET/myfile-2.txt",
"/DOC-EXAMPLE-BUCKET/myfile-3.txt"
],
"RemoteDirectoryPath": "/MySFTPRootFolder/fromTranferFamilyServer"
}Risposta di esempio
{
"TransferId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}Esempio
L'esempio seguente avvia un trasferimento di file da un SFTP server remoto all' AWS archiviazione locale.
Richiesta di esempio
{
"ConnectorId": "c-111122223333AAAAA",
"RetrieveFilePaths": [
"/MySFTPFolder/toTranferFamily/myfile-1.txt",
"/MySFTPFolder/toTranferFamily/myfile-2.txt",
"/MySFTPFolder/toTranferFamily/myfile-3.txt"
],
"LocalDirectoryPath": "/DOC-EXAMPLE-BUCKET/mySourceFiles"
}Risposta di esempio
{
"TransferId": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa"
}Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API opzione in una delle lingue specifiche AWS SDKs, consulta quanto segue:
