SFTP 커넥터를 사용하여 파일을 보내고 검색합니다.

SFTP 커넥터는 클라우드와 온프레미스 모두에서 원격 서버와 AWS Transfer Family 통신할 수 있도록 기능을 확장합니다. 원격 소스에서 생성 및 저장된 데이터를 분석, 비즈니스 애플리케이션, 보고 및 감사를 위해 AWS 호스팅된 데이터 웨어하우스와 통합할 수 있습니다.

원격 SFTP 서버로 파일 전송을 시작하려면 SFTP 커넥터를 사용하여 전송을 수행하는 StartFileTransfer API 작업을 사용합니다. 각 StartFileTransfer 요청에는 10개의 고유한 경로가 포함될 수 있습니다.

서버 로그를 확인하여 파일 전송을 모니터링할 수 있습니다. 커넥터 활동은 aws/transfer/connector-id 형식(예: aws/transfer/c-1234567890abcdef0)의 로그 스트림에 기록됩니다. 커넥터에 대한 로그가 표시되지 않는 경우 커넥터에 대한 올바른 권한을 가진 로깅 역할을 지정했는지 확인하세요.

커넥터 생성에 대한 자세한 설명은 SFTP 커넥터 구성 섹션을 참조하세요.

SFTP 커넥터를 사용하여 파일을 보내고 검색하려면 () 명령을 사용합니다. start-file-transfer AWS Command Line Interface AWS CLI파일 전송(아웃바운드 전송) 또는 파일 수신(인바운드 전송) 여부에 따라 다음 매개 변수를 지정합니다.

• 아웃바운드 전송

  • send-file-paths에는 파트너의 SFTP 서버로 전송할 파일을 위한 1~10개의 소스 파일 경로가 포함됩니다.

  • remote-directory-path는 고객의 SFTP 서버에서 파일을 전송할 원격 경로입니다.

• 인바운드 전송

  • retrieve-file-paths에는 1~10개의 원격 경로가 포함됩니다. 각 경로는 파트너의 SFTP 서버에서 Transfer Family 서버로 파일을 전송할 위치를 지정합니다.

  • local-directory-path는 파일이 저장되는 Amazon S3 위치 (버킷 및 선택적 접두사) 입니다.

파일을 보내려면 send-file-paths 및 remote-directory-path 파라미터를 지정합니다. 최대 10개의 파일을 send-file-paths 파라미터에 지정할 수 있습니다. 다음 예 명령은 Amazon S3 스토리지에 있는 /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt 및 /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt라는 파일을 파트너의 SFTP 서버의 /tmp 디렉터리로 보냅니다. 이 예 명령을 사용하려면 DOC-EXAMPLE-SOURCE-BUCKET를 실제 버킷으로 대체하세요.

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt \
    --remote-directory-path /tmp --connector-id c-1111AAAA2222BBBB3 --region us-east-2

파일을 수신하려면 retrieve-file-paths 및 local-directory-path 파라미터를 지정합니다. 다음 예제는 파트너의 SFTP 서버에서 파일을 /my/remote/file1.txt 검색하여 Amazon S3 위치 /DOC-EXAMPLE-BUCKET/ 접두사에 추가합니다. /my/remote/file2.txt 이 예 명령을 사용하려면 user input placeholders를 실제 정보로 대체하세요.

aws transfer start-file-transfer --retrieve-file-paths /my/remote/file1.txt  /my/remote/file2.txt \
   --local-directory-path /DOC-EXAMPLE-BUCKET/prefix --connector-id c-2222BBBB3333CCCC4 --region us-east-2

이전 예는 SFTP 서버의 절대 경로를 지정합니다. 상대 경로, 즉 SFTP 사용자의 홈 디렉터리를 기준으로 하는 경로를 사용할 수도 있습니다. 예컨대, SFTP 사용자가 marymajor이고 SFTP 서버의 홈 디렉터리가 /users/marymajor/인 경우 다음 명령은 /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt을 /users/marymajor/test-connectors/file1.txt으로 전송합니다.

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt \
   --remote-directory-path test-connectors --connector-id c-2222BBBB3333CCCC4 --region us-east-2