SFTP コネクタを使用してファイルを送受信します。

SFTP コネクタは、クラウドとオンプレミスの両方でリモートサーバーと通信 AWS Transfer Family するために の機能を拡張します。リモートソースで生成および保存されたデータを、分析、ビジネスアプリケーション、レポート、監査のために AWS ホストされたデータウェアハウスと統合できます。

リモート SFTP サーバーへのファイル転送を開始するには、SFTP コネクターを使用して転送を行う StartFileTransferAPI 操作を使用します。各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 個のファイルを指定できます。以下のコマンド例では、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/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