翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# クライアントを使用してサーバーエンドポイント経由でファイルを転送する
クライアントで転送オペレーションを指定して、 AWS Transfer Family サービス経由でファイルを転送します。 は次のクライアント AWS Transfer Family をサポートしています。
+ SFTP プロトコルのバージョン 3 をサポートしています。
+ OpenSSH (macOS および Linux)
**注記**
このクライアントは、Secure Shell (SSH) File Transfer Protocol (SFTP) が有効なサーバーとの組み合わせでのみ機能します。
+ WinSCP (Microsoft Windows のみ)
+ Cyberduck (Windows、macOS、および Linux)
+ FileZilla (Windows、macOS、および Linux)
どのクライアントにも以下の制限が適用されます。
+ SCP プロトコルは安全でないと見なされるため、サポートされていません。「」で説明されているように、OpenSSH `scp` コマンドを使用できます[`scp` コマンドの使用](#openssh-scp)。
+ 1 接続あたりの、同時、多重化された SFTP セッションの最大数は 10 です。
+ アイドル接続の場合、タイムアウト値はすべてのプロトコル (SFTP/FTP/FTPS) で 1800 秒 (30 分) です。この期間後にアクティビティがない場合、クライアントが切断される可能性があります。応答しない接続の場合:
+ クライアントが完全に応答しない場合、SFTP のタイムアウトは 300 秒 (5 分) です。
+ FTPS と FTP には、基盤となるライブラリによって処理される約 10 分の応答しないタイムアウトがあります。
+ Amazon S3 と Amazon EFS (NFSv4 プロトコルのため) では、ファイル名は UTF-8 エンコーディングである必要があります。異なるエンコーディングを使用すると、予期しない結果になることがあります。Amazon S3 については、「[オブジェクトキーの命名ガイドライン](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines)」を参照してください。
+ File Transfer Protocol over SSL (FTPS) については、明示モードのみがサポートされます。暗黙モードはサポートされません。
+ FTP および FTPS では、パッシブモードのみがサポートされます。
+ FTP および FTPS では、STREAM モードのみがサポートされます。
+ FTP および FTPS では、イメージ/バイナリモードのみがサポートされます。
+ FTP および FTPS の場合、データ接続の TLS - PROT C (保護されていない) TLS がデフォルトですが、FTPS AWS Transfer Family プロトコルでは PROT C はサポートされていません。つまり、FTPS の場合は、PROT P を発行してデータ操作を受け付ける必要があります。
+ サーバーのストレージに Amazon S3 を使用していて、1 回の転送に複数の接続を使用するオプションがクライアントに含まれている場合は、必ずそのオプションを無効にしてください。そうしないと、大容量ファイルのアップロードが失敗して予測外の状況になる可能性があります。Amazon EFS をストレージバックエンドとして使用している場合、EFS は 1 回の転送で複数の接続をサポート「する」ことに注意してください。
以下に示すのは、FTP および FTPS で使用できるコマンドの一覧です。
| 使用できるコマンド |
| --- |
| ABOR | FEAT | MLST | PASS | RETR | STOR |
| AUTH | LANG | MKD | PASV | RMD | STOU |
| CDUP | LIST | MODE | PBSZ | RNFR | STRU |
| CWD | MDTM | NLST | PROT | RNTO | SYST |
| DELE | MFMT | NOOP | PWD | SIZE | TYPE |
| EPSV | MLSD | OPTS | QUIT | STAT | USER |
**注記**
APPE はサポートされません。
SFTP については、Amazon Elastic File System (Amazon EFS) を使用しているサーバーで論理ホームディレクトリを使用するユーザーの場合、現時点で以下のオペレーションはサポートされていません。
| サポートされない SFTP コマンド |
| --- |
| SSH\$1FXP\$1READLINK | SSH\$1FXP\$1SYMLINK | リクエストされたファイルがシンボリックリンクの場合、SSH\$1FXP\$1STAT | リクエストされたパスにシンボリックリンクコンポーネントが含まれている場合、SSH\$1FXP\$1REALPATH |
**パブリックキーとプライベートキーのペアを生成する**
ファイルを転送する前に、パブリックキーとプライベートキーのキーペアを用意する必要があります。以前にキーペアを生成していない場合、「[サービス管理ユーザーの SSH キーの生成](sshkeygen.md)」を参照してください。
**Topics**
+ [使用可能な SFTP/FTPS/FTP コマンド](#transfer-sftp-commands)
+ [Amazon VPC エンドポイントを検索する](#find-vpc-endpoint)
+ [`setstat`エラーを回避する](#avoid-set-stat)
+ [OpenSSH を使用する](#openssh)
+ [WinSCP を使用する](#winscp)
+ [Cyberduck を使用する](#cyberduck)
+ [FileZilla を使用する](#filezilla)
+ [Perl クライアントを使用する](#using-clients-with-perl-modules)
+ [LFTP を使用する](#using-client-lftp)
+ [アップロード後の処理](#post-processing-upload)
+ [SFTP メッセージ](#sftp-transfer-activity-types)
## 使用可能な SFTP/FTPS/FTP コマンド
次の表に、SFTP AWS Transfer Family、FTPS、および FTP プロトコルで使用できるコマンドを示します。
**注記**
この表には、バケットとオブジェクトのみをサポートする Amazon S3 の「ファイル」と「ディレクトリ」が記載されています。階層はありません。ただし、オブジェクトキー名にプレフィックスを使って階層を示したり、フォルダのようにデータを整理したりすることはできます。この動作については、「Amazon Simple Storage Service ユーザーガイド」の「[オブジェクトメタデータの処理](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html)」で説明されています。
**SFTP/FTPS/FTP コマンド**
| コマンド | Amazon S3 | Amazon EFS |
| --- | --- | --- |
| cd | サポート対象 | サポート |
| chgrp | サポートされていません | 対応（root または owner のみ） |
| chmod | サポートされていません | サポート (rootのみ) |
| chmtime | サポート外 | サポート |
| chown | サポートされていません | サポート (rootのみ) |
| get | サポート | サポート (シンボリックリンクの解決を含む) |
| ln -s | サポート外 | サポート対象 |
| ls/dir | サポート対象 | サポート対象 |
| mkdir | サポート対象 | サポート対象 |
| put | サポート対象 | サポート対象 |
| pwd | サポート対象 | サポート |
| rename | ファイルでのみサポート 既存のファイルを上書きする名前変更はサポートされていません。 | サポート 既存のファイルやディレクトリを上書きするような名前変更はサポートされていません。 |
| rm | サポート対象 | サポート |
| rmdir | サポート (空のディレクトリのみ) | サポート対象 |
| version | サポート対象 | サポート |
## Amazon VPC エンドポイントを検索する
Transfer FamilyサーバーのエンドポイントタイプがVPC の場合、ファイルの転送に使用するエンドポイントを特定するのは簡単ではありません。この場合、次の手順を使用して、Amazon VPC エンドポイントを検索します。
**Amazon VPC エンドポイントを検索するには**
1. サーバーの詳細ページに移動します。
1. **[エンドポイントの詳細]** ペインで、**[VPC]** を選択します。
![\[\]](http://docs.aws.amazon.com/ja_jp/transfer/latest/userguide/images/server-details-endpoint-vpc.png)
1. Amazon VPC ダッシュボードで **[VPC エンドポイント ID]** を選択します。
1. **[DNS 名]**のリストでは、サーバーエンドポイントが最初に表示されます。
![\[\]](http://docs.aws.amazon.com/ja_jp/transfer/latest/userguide/images/server-details-endpoint-vpc-2.png)
## `setstat`エラーを回避する
SFTP ファイル転送クライアントの中には、ファイルをアップロードする 際に SETSTAT などのコマンドを使用して、タイムスタンプやパーミッションな ど、リモートファイルの属性を変更しようとするものがあります。ただし、これらのコマンドは Amazon S3 などのオブジェクトストレージシステムと互換性がありません。この非互換性が原因で、これらのクライアントからファイルをアップロードする際に、ファイルが正常にアップロードされた場合でもエラーが発生する可能性があります。
+ `CreateServer` または `UpdateServer` API を呼び出すときに、`ProtocolDetails` オプション `SetStatOption` を使用して、クライアントが S3 バケットにアップロードするファイルに SETSTAT を使用しようとしたときに生成されるエラーを無視します。
+ Transfer Family サーバーが SETSTAT コマンドを無視するように値を `ENABLE_NO_OP` に設定し、SFTP クライアントに変更を加えることなくファイルをアップロードできます。
+ `SetStatOption` `ENABLE_NO_OP` 設定はエラーを無視するが、CloudWatch Logsにログエントリを「生成する」ので、クライアントがいつ SETSTAT コールを行っているかを判断できます。
このオプションの API の詳細については、「[プロトコルの詳細](https://docs.aws.amazon.com/transfer/latest/APIReference/API_ProtocolDetails.html)」を参照してください。
## OpenSSH を使用する
このセクションでは、OpenSSH を使用してコマンドラインからファイルを転送する手順について説明します。
**注記**
このクライアントは SFTP 対応サーバーでのみ動作します。
**Topics**
+ [OpenSSH を使用する](#openssh-use)
+ [`scp` コマンドの使用](#openssh-scp)
### OpenSSH を使用する
**OpenSSH コマンドラインユーティリティ AWS Transfer Family を使用してファイルを 経由で転送するには**
1. Linux、macOS、Windows では、コマンドターミナルを開きます。
1. プロンプトで、次のコマンドを入力します。
`sftp -i transfer-key sftp_user@service_endpoint`
前述のコマンドでは、`sftp_user` がユーザー名、`transfer-key` が SSH プライベートキーです。ここで、 `service_endpoint`は、選択したサーバーの AWS Transfer Family コンソールに表示されるサーバーのエンドポイントです。
**注記**
このコマンドは、デフォルトの `ssh_config` ファイルにある設定を使用します。このファイルを以前に編集していない限り、SFTP はポート 22 を使用します。次のように コマンドに**-P**フラグを追加することで、別のポート (2222 など) を指定できます。
```
sftp -P 2222 -i transfer-key sftp_user@service_endpoint
```
または、常にポート 2222 またはポート 22000 を使用する場合は、 `ssh_config` ファイル内のデフォルトポートを更新できます。
`sftp` プロンプトが表示されます。
1. (オプション) ユーザーのホームディレクトリを表示するには、`sftp` プロンプトで次のコマントを入力します。
`pwd`
1. ご使用のファイルシステムから Transfer Family サーバーにファイルをアップロードするには、`put` コマンドを使用します。たとえば、`hello.txt` をアップロードするには (ファイルがファイルシステム上のカレントディレクトリにあると仮定して)、`sftp` プロンプトで次のコマンドを実行します。
`put hello.txt`
ファイル転送が進行中か完了したことを示す次のようなメッセージが表示されます。
`Uploading hello.txt to /amzn-s3-demo-bucket/home/sftp_user/hello.txt`
`hello.txt 100% 127 0.1KB/s 00:00`
**注記**
サーバーの作成後、お使いの環境の DNS サービスによってサーバーエンドポイントのホスト名が解決可能になるまでに数分かかることがあります。
### `scp` コマンドの使用
Transfer Family は SCP プロトコルをサポートしていません。ただし、この機能が必要な場合は OpenSSH `scp` コマンドを使用できます。
SFTP 経由で SCP を使用するための推奨事項は、OpenSSH バージョン 9.0 以降を使用することです。OpenSSH バージョン 9 以降では、`scp`コマンドはデフォルトでレガシー SCP プロトコルの代わりにファイル転送に SFTP プロトコルを使用します。
**重要**
Transfer Family サーバーが S3 最適化ディレクトリアクセスを使用するように設定されていることを確認します。
## WinSCP を使用する
次の手順に従って、WinSCP を使用してコマンドラインからファイルを転送します。
**注記**
WinSCP 5.19 を使用する場合、 AWS 認証情報で Amazon S3 に直接接続してファイルのアップロード/ダウンロードが可能です。詳細については、「[Amazon S3 サービスに接続する](https://winscp.net/eng/docs/guide_amazon_s3)」を参照してください。
**WinSCP AWS Transfer Family を使用して 経由でファイルを転送するには**
1. WinSCP クライアントを開きます。
1. [**Login**] (ログイン) ダイアログボックスで [**File protocol**] (ファイルプロトコル) として **SFTP** または **FTP** を選択します。
[FTP] を選択した場合、[**Encryption**] (暗号化) で次のいずれかを選択します。
+ FTP の場合、**暗号化なし**
+ FTPS の場合、**TLS/SSL 明示的な暗号化**
1. [**Host name**] (ホスト名) にサーバーエンドポイントを入力します。サーバーエンドポイントは、[**Server details**] (サーバーの詳細) ページにあります 。詳細については、「[SFTP、FTPS、FTP サーバーの詳細を表示する](configuring-servers-view-info.md)」を参照してください。
サーバーが VPC エンドポイントを使用している場合は、[Amazon VPC エンドポイントを検索する](#find-vpc-endpoint)を参照してください。
1. [**Port number**] (ポート番号) に次の値を入力します。
+ SFTP の場合、**22**
+ FTP/FTPS の場合、**21**
1. **[ユーザー名]** には、特定の ID プロバイダー用に作成したユーザーの名前を入力します。
**ヒント: **ユーザー名は、ID プロバイダー用に作成または設定したユーザーの 1 人である必要があります。 は、次の ID プロバイダー AWS Transfer Family を提供します。
+ [サービスマネージドユーザーの使用](service-managed-users.md)
+ [AWS Directory Service for Microsoft Active Directory の使用](directory-services-users.md)
+ [カスタム ID プロバイダーの使用](custom-idp-intro.md)
1. [**Advanced**] (アドバンスト) を選択して、[**Advanced Site Settings**] (サイトのアドバンスト設定) ダイアログボックスを開きます。[**SSH**] セクションで [**Authentication**] (認証) を選択します。
1. [**Private key file**] (プライベートキーファイル) でファイルシステムから SSH プライベートキーを参照して選択します。
WinSCP から SSH プライベートキーを PPK 形式に変換するオプションが表示されたら [**OK**] を選択します。
1. [**OK**] を選択して [**Login**] (ログイン) ダイアログボックスに戻り、[**Save**] (保存) を選択します。
1. [**Save session as site**] (セッションをサイトとして保存) ダイアログボックスで [**OK**] を選択して接続セットアップを完了します。
1. [**Login**] (ログイン) ダイアログボックスで [**Tools**] (ツール) を選択してから[**Preferences**] (設定) を選択します。
1. [**Preferences**] (設定) ダイアログボックスの [**Transfer**] (転送) で [**Endurance**] (耐久性) を選択します。
[**Enable transfer resume/transfer to temporary filename for**] オプションについて [**Disable**] (無効にする) を選択します。
**重要**
このオプションを有効にしたままにすると、アップロードコストが増加し、アップロードのパフォーマンスが大幅に低下します。大容量ファイルのアップロードが失敗する可能性もあります。
1. [**Transfer**] (転送) で [**Background**] (バックグラウンド) を選択し、[**Use multiple connections for single transfer**] (単一の転送に複数の接続を使用する) チェックボックスをオフにします。
**ヒント: **このオプションを選択したままにすると、大きなファイルのアップロードが予測不可能な方法で失敗する可能性があります。たとえば、孤立マルチパートアップロードが生成されて Amazon S3 の料金が発生する可能性があります。サイレントデータ破損が発生することもあります。
1. ファイル転送を実行します。
ドラッグアンドドロップ方式により、コピー先とコピー元のウィンドウ間でファイルをコピーできます。ツールバーアイコンを使用して、WinSCP にあるファイルのプロパティをアップロード/ダウンロード、削除、編集、または変更できます。
**注記**
Amazon EFS をストレージに使用している場合、この注意事項は適用されません。
タイムスタンプを含むリモートファイルの属性を変更しようとするコマンドは Amazon S3 などのオブジェクトストレージシステムと互換性がありません。そのため、Amazon S3 をストレージとして使用している場合は、ファイル転送を実行する前に、WinSCP タイムスタプ設定を必ず無効にしてください (または、[`setstat`エラーを回避する](#avoid-set-stat)で説明したように`SetStatOption`を使う)。そのためには、**WinSCP Transfer settings** (WinSCP 転送設定) ダイアログボックスで [**Set permissions**] (パーミッションの設定) オプションと [**Preserve timestamp**] (タイムスタンプを保持) オプションを無効にします。
## Cyberduck を使用する
次の手順に従って、Cyberduck を使用してコマンドラインからファイルを転送します。
**Cyberduck AWS Transfer Family を使用してファイルを 経由で転送するには**
1. [Cyberduck](https://cyberduck.io/download/) クライアントを開きます。
1. [**Open connection**] (接続を開く) を選択します。
1. [**Open Connection**] (接続を開く) ダイアログボックスでプロトコルとして **SFTP (SSH File Transfer Protocol)**、**FTP-SSL (Explicit AUTH TLS)**、または **FTP (File Transfer Protocol)** を選択します。
1. [**Servers**] (サーバー) にサーバーのエンドポイントを入力します。サーバーエンドポイントは、[**Server details**] (サーバーの詳細) ページにあります 。詳細については、「[SFTP、FTPS、FTP サーバーの詳細を表示する](configuring-servers-view-info.md)」を参照してください。
サーバーが VPC エンドポイントを使用している場合は、[Amazon VPC エンドポイントを検索する](#find-vpc-endpoint)を参照してください。
1. [**Port number**] (ポート番号) に次の値を入力します。
+ SFTP の場合、**22**
+ FTP/FTPS の場合、**21**
1. [**Username**] (ユーザー名) に [サーバーエンドポイントのユーザーの管理](create-user.md) で作成したユーザーの名前を入力します。
1. SFTP を選択した場合、[**SSH Private Key**] (SSH プライベートキー) で SSH プライベートキー] を選択するか入力します。
1. [**Connect**] (接続) を選択します。
1. ファイル転送を実行します。
ファイルの場所に応じて、次のいずれかの操作をします。
+ ローカルディレクトリ (転送元) で転送したいファイルを選択して Amazon S3 ディレクトリ (転送先) にドラッグアンドドロップします。
+ Amazon S3 ディレクトリ (転送元) で転送したいファイルを選択してローカルディレクトリ (転送先) にドラッグアンドドロップします。
## FileZilla を使用する
次の手順に従って、FileZilla を使用してファイルを転送します。
**FileZilla をファイル転送用に設定するには**
1. FileZilla クライアントを開きます。
1. [**File**] (ファイル) を選択してから [**Site Manager**] を選択します。
1. [**Site Manager**] ダイアログボックスで [**New site**] (新しいサイト) を選択します。
1. [**General**] (全般) タブの [**Protocol**] (プロトコル) で **SFTP** または **FTP** のプロトコルを選択します。
[FTP] を選択した場合、[**Encryption**] (暗号化) で次のいずれかを選択します。
+ **平文 FTP のみを使用する (安全でない)** — FTP の場合
+ **TLS 経由の明示的な FTP を (可能であれば) 使用する** — FTPS の場合
1. [**Host name**] (ホスト名) には、使用するプロトコルを入力し、その後にサーバーエンドポイントを続けます。サーバーエンドポイントは、[**Server details**] (サーバーの詳細) ページにあります 。詳細については、「[SFTP、FTPS、FTP サーバーの詳細を表示する](configuring-servers-view-info.md)」を参照してください。
+ SFTP を使用する場合、`sftp://hostname` を入力します。
+ FTPS を使用する場合、`ftps://hostname` を入力します。
*hostname* を実際のサーバーエンドポイントに確実に置き換えてください。
サーバーが VPC エンドポイントを使用している場合は、[Amazon VPC エンドポイントを検索する](#find-vpc-endpoint)を参照してください。
1. [**Port number**] (ポート番号) に次の値を入力します。
+ SFTP の場合、**22**
+ FTP/FTPS の場合、**21**
1. [SFTP] を選択した場合、[**Logon type**] (ログオンの種類) で [**Key file**] (キーファイル) を選択します。
[**Key file**] (キーファイル) で SSH プライベートキーを選択するか入力します。
1. [**Username**] (ユーザー名) に、[サーバーエンドポイントのユーザーの管理](create-user.md) で作成したユーザーの名前を入力します。
1. [**Connect**] (接続) を選択します。
1. ファイル転送を実行します。
**注記**
進行中のファイル転送を中断すると、Amazon S3 バケットに部分的なオブジェクトが書き込まれる AWS Transfer Family 可能性があります。アップロードを中断する場合、続行する前に Amazon S3 バケットのファイルサイズがソースオブジェクトのファイルサイズと一致することを確認してください。
## Perl クライアントを使用する
NET:: SFTP:: 外部の perl クライアントを使用する場合は、を `queue_size` に設定する必要があります `1`。例:
`my $sftp = Net::SFTP::Foreign->new('user@s-12345.server.transfer.us-east-2.amazonaws.com', queue_size => 1);`
**注記**
この回避策は、[1.92.02](https://metacpan.org/changes/release/SALVA/Net-SFTP-Foreign-1.93#L12) 以前の `Net::SFTP::Foreign` のリビジョンに必要です。
## LFTP を使用する
LFTP は、ほとんどの Linux マシンからのコマンドラインインターフェイスを介したファイル転送をユーザーに許可する無料の FTP クライアントです。
大きなファイルのダウンロードの場合、LFTP には順序の異なるパケットに関する既知の問題があり、ファイル転送が失敗します。
## アップロード後の処理
Amazon S3 オブジェクトのメタデータやイベント通知など、アップロード後の処理情報を表示できます。
**Topics**
+ [Amazon S3 オブジェクトメタデータ](#post-processing-S3-object-metadata)
+ [Amazon S3 イベント通知](#post-processing-S3-event-notifications)
### Amazon S3 オブジェクトメタデータ
オブジェクトのメタデータの一部として、値が `AWSTransfer` である `x-amz-meta-user-agent` と値が `username@server-id` である `x-amz-meta-user-agent-id` というキーが見えます。`username` はファイルをアップロードしたTransfer Family ユーザー、`server-id` はアップロードに使用したサーバーです。この情報には、Lambda 関数内の S3 オブジェクトで [HeadObject](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html) オペレーションを使用してアクセスできます。
![\[の Amazon S3 オブジェクトメタデータに関する情報を表示するメタデータ画面 AWS Transfer Family。\]](http://docs.aws.amazon.com/ja_jp/transfer/latest/userguide/images/s3-object-metadata.png)
### Amazon S3 イベント通知
Transfer Family を使用してオブジェクトを S3 バケットにアップロードすると、[S3 イベント通知構造](https://docs.aws.amazon.com/AmazonS3/latest/dev/notification-content-structure.html)で `RoleSessionName` が [Requester] (リクエスタ) フィールドに `[AWS:Role Unique Identifier]/username.sessionid@server-id` として含まれます。たとえば、次に示すのは S3 バケットにコピーされたファイルの S3 アクセスログから得たサンプル [Requester] (リクエスタ) フィールドのコンテンツです。
`arn:aws:sts::AWS-Account-ID:assumed-role/IamRoleName/username.sessionid@server-id`
上記の [Requester] (リクエスタ) フィールドには、`IamRoleName` と呼ばれる IAM ロールが表示されます。S3 イベント通知を設定する方法の詳細については、*Amazon Simple Storage Service デベロッパーガイド*の「[Amazon S3 イベント通知の設定](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html)」を参照してください。 AWS Identity and Access Management (IAM) ロールの一意の識別子の詳細については、*AWS Identity and Access Management 「 ユーザーガイド*」の[「一意の識別子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-unique-ids)」を参照してください。
## SFTP メッセージ
このセクションでは、Transfer Family サーバーの使用時に SFTP ファイル転送中または転送後に受信するクライアント側のメッセージについて説明します。SFTP イベントの詳細については、SFTP クライアントログを確認してください。この情報を使用してエラーをトラブルシューティングしたり、その情報をネットワークチームに転送して問題の特定に役立てることができます。
**SFTP クライアント側のメッセージ**
| アクティビティ | 説明 |
| --- | --- |
| AUTH\$1FAILURE | ユーザーが認証に失敗しました。これは、カスタム ID プロバイダーまたはサービスマネージドユーザーによる任意の種類の障害である可能性があります。イベントの詳細は、障害の根本原因を明確にするのに役立ちます。 |
| CLOSE | 開いたファイルまたはディレクトリが正常に閉じられたことを示します。 |
| 接続/切断 | 通常の接続の成功と切断を示します。 |
| CREATE\$1SYMLINK | シンボリックリンクが作成されました (成功または失敗）。 |
| DELETE | ファイルが削除されました (成功または失敗）。 |
| エラー | 一般的な予期しないエラー。関連する説明には、ユーザーまたはネットワーク管理者が特定の問題を特定するのに役立つ情報が含まれています。 |
| EXIT\$1REASON | 予期しないエラーにより SFTP セッションが終了したときに出力されます。イベントに関連付けられたメッセージは、原因を記述します。 |
| MKDIR | ディレクトリが作成されました (成功または失敗）。 |
| OPEN | ファイルが読み取りまたは書き込み用に開かれた (成功または失敗) |
| PARTIAL\$1CLOSE | ファイルがまだ開いていて CLOSE メッセージを受信していない間に、クライアントがサーバーから切断されました。Transfer Family は、ファイルの受信した部分 (実際には完全なファイルである可能性があります) を保存し、PARTIAL\$1CLOSE イベントを発行して、お客様に問題を警告します。ワークフロー統合は、ファイルを適切に処理するためのonPartialCloseイベントも受け取ります。 |
| RENAME | ファイルの名前が変更されました (成功または失敗) |
| RMDIR | ディレクトリが削除された (成功または失敗) |
| SETSTAT | ファイルの属性が変更されます (成功または失敗）。 ストレージに Amazon S3 を使用している場合、Transfer Family は SETSTAT をサポートしていません。このセクションでは[`setstat`エラーを回避する](#avoid-set-stat)、 `SetStat` 設定をオフにしてエラーを回避する方法について詳しく説明します。これにより、 の受信を回避できます`fail unsupported error`。代わりに、`success but do nothing`メッセージが表示されます。 |
| TLS\$1RESUME\$1FAILURE | サーバーは TLS セッション再開を適用するように設定されており、クライアントはそれをサポートしていません。 |