기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
StartFileTransfer
로컬 AWS 스토리지와 원격 AS2 또는 SFTP 서버 간에 파일 전송을 시작합니다.
-
AS2 커넥터의 경우
ConnectorId및 하나 이상을 지정SendFilePaths하여 전송하려는 파일을 식별합니다. -
SFTP 커넥터의 경우 파일 전송은 아웃바운드 또는 인바운드일 수 있습니다. 두 경우 모두
ConnectorId를 지정합니다. 전송 방향에 따라 다음 항목도 지정합니다.-
파트너의 서버에서 SFTP Amazon Web Services 스토리지로 파일을 전송하는 경우 전송할 파일을 식별
RetreiveFilePaths하도록 하나 이상을 지정하고 대상 폴더를 지정LocalDirectoryPath하도록 를 지정합니다. -
스토리지에서 AWS 파트너의 SFTP 서버로 파일을 전송하는 경우 전송할 파일을 식별
SendFilePaths하도록 하나 이상을 지정하고 대상 폴더를 지정RemoteDirectoryPath하도록 를 지정합니다.
-
구문 요청
{
"ConnectorId": "string",
"LocalDirectoryPath": "string",
"RemoteDirectoryPath": "string",
"RetrieveFilePaths": [ "string" ],
"SendFilePaths": [ "string" ]
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 수락합니다.
- ConnectorId
-
커넥터의 고유 식별자입니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
Pattern:
c-([0-9a-f]{17})필수 여부: 예
- LocalDirectoryPath
-
인바운드 전송의 경우 는 파트너의 SFTP 서버에서 전송되는 하나 이상의 파일의 대상을
LocaDirectoryPath지정합니다.유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
패턴:
(.)+Required: No
- RemoteDirectoryPath
-
아웃바운드 전송의 경우 는 파트너의 SFTP 서버로 전송되는 하나 이상의 파일의 대상을
RemoteDirectoryPath지정합니다. 를 지정하지 않으면 전송RemoteDirectoryPath된 파일의 대상은 SFTP 사용자의 홈 디렉터리입니다.유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1024입니다.
패턴:
(.)+Required: No
- RetrieveFilePaths
-
파트너 SFTP 서버의 소스 경로가 하나 이상 있습니다. 각 문자열은 한 번의 인바운드 File Transfer에 대한 소스 파일 경로를 나타냅니다.
타입: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 10개입니다.
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 1024입니다.
패턴:
(.)+Required: No
- SendFilePaths
-
Amazon S3 스토리지를 위한 하나 이상의 소스 경로. 각 문자열은 한 번의 아웃바운드 파일 전송에 대한 소스 파일 경로를 나타냅니다. 예:
DOC-EXAMPLE-BUCKET/myfile.txt.참고
DOC-EXAMPLE-BUCKET를 실제 버킷 중 하나와 바꾸세요.타입: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 10개입니다.
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 1024입니다.
패턴:
(.)+필수 여부: 아니요
응답 구문
{
"TransferId": "string"
}Response Elements
작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.
다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.
- TransferId
-
파일 전송에 대해 고유 식별자를 반환합니다.
타입: 문자열
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 512입니다.
패턴:
[0-9a-zA-Z./-]+
Errors
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.
- InternalServiceError
-
이 예외는 AWS Transfer Family 서비스에서 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
AWS Transfer Family 서비스에서 리소스를 찾을 수 없는 경우 이 예외가 발생합니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
AWS Transfer Family 서비스를 사용할 수 없으므로 요청이 실패했습니다.
HTTP 상태 코드: 500
- ThrottlingException
-
요청 제한 때문에 요청이 거부되었습니다.
HTTP 상태 코드: 400
예시
예
다음 예제에서는 Transfer Family 서버에서 원격 거래 파트너의 엔드포인트로 AS2 파일 전송을 시작합니다.
DOC-EXAMPLE-BUCKET
를 실제 버킷 중 하나로 바꾸세요.
샘플 요청
{
"ConnectorId": "c-AAAA1111BBBB2222C",
"SendFilePaths": [
"/DOC-EXAMPLE-BUCKET/myfile-1.txt",
"/DOC-EXAMPLE-BUCKET/myfile-2.txt",
"/DOC-EXAMPLE-BUCKET/myfile-3.txt"
]
}샘플 응답
{
"TransferId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}예
다음 예제에서는 로컬 AWS 스토리지에서 원격 SFTP 서버로 파일 전송을 시작합니다.
샘플 요청
{
"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"
}샘플 응답
{
"TransferId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}예
다음 예제에서는 원격 SFTP 서버에서 로컬 AWS 스토리지로 파일 전송을 시작합니다.
샘플 요청
{
"ConnectorId": "c-111122223333AAAAA",
"RetrieveFilePaths": [
"/MySFTPFolder/toTranferFamily/myfile-1.txt",
"/MySFTPFolder/toTranferFamily/myfile-2.txt",
"/MySFTPFolder/toTranferFamily/myfile-3.txt"
],
"LocalDirectoryPath": "/DOC-EXAMPLE-BUCKET/mySourceFiles"
}샘플 응답
{
"TransferId": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa"
}참고
언어별 중 하나API에서 이 를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.
