SFTP コネクタを使用してファイルを送信および取得する

SFTP コネクタは、 クラウドとオンプレミスの両方でリモートサーバーと通信 AWS Transfer Family する の機能を拡張します。リモートソースで生成および保存されたデータを、分析、ビジネスアプリケーション、レポート、監査のために AWS ホストされたデータウェアハウスと統合できます。リモートSFTPサーバーへのファイル転送を開始するには、 を使用します。 StartFileTransfer API オペレーション。コネクタを使用して転送SFTPを実行します。各StartFileTransferリクエストには 10 個の異なるパスを含めることができます。

サーバーログを確認することで、ファイル転送を監視できます。コネクタアクティビティは、aws/transfer/c-1234567890abcdef0 などの aws/transfer/connector-id 形式のログストリームに記録されます。コネクタのログが表示されない場合は、コネクタの正しい権限を持つロギングロールを指定していることを確認してください。

コネクターの作成については、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パラメータを指定します。send-file-pathsパラメータには最大 10 個のファイルを指定できます。次のコマンド例では/DOC-EXAMPLE-SOURCE-BUCKET/file2.txt、Amazon S3 ストレージにある /DOC-EXAMPLE-SOURCE-BUCKET/file1.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/my/remote/file2.txt上の ファイルと を取得し、Amazon S3 の場所 / に配置します。DOC-EXAMPLE-BUCKET/prefix。 このコマンド例を使用するには、 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