SFTPでファイルをダウンロード

dosyaのSFTPは通常の読み取りとオフセット読み取りに対応しています。64 MiB未満のファイルはメモリ内の読み取り経路を使用し、64 MiB以上のファイルは範囲を限定したリクエストを使用します。そのため、大きなダウンロードは開始までに時間がかかったり速度が異なったりする場合があります。SFTPのダウンロードサイズに上限はありませんが、ロール、キー、送信量、同時実行数の制限によってリクエストが拒否される場合があります。

SFTPプロトコルと目的のワークスペースを含む読み取り専用またはフルアクセスのAPIキーを使用してください。サインインのユーザー名はキーオーナーのメールアドレスと、大文字と小文字も含めて完全に一致する必要があります。/で一覧にあるワークスペース名またはスラッグを選んでから、そのフォルダーにアクセスしてください。

手順

1. sftp.dosya.devのポート2222に接続し、lsを実行して、ファイルがあるワークスペースに入ってください。リモートのパス名と、statまたはクライアントの一覧に表示されるサイズを記録します。
2. 古い部分コピーを今回のものと間違えないよう、新しいローカルの保存先を選んでください。OpenSSHではget "remote-name.ext" "./remote-name.ext"を使います。GUIクライアントではダウンロードを使用できます。
3. read failed、Permission denied、No such fileの応答がなく転送が完了するまで待ってください。フォルダーキャッシュでパスが見つからなかった場合、そのパスは一度再確認されます。
4. ローカルのバイト数をリモートの一覧と比較してください。整合性を確認するには、ダウンロードしたファイルのSHA-256を計算し、信頼できるチェックサムまたは別途検証した元ファイルのコピーと比較します。
5. 転送が停止してもリモートファイルが変更されていなければ、オフセット読み取りを行うクライアントで再開してください。中断中にリモートの名前、サイズ、現在のバージョンが変わった場合は必ず0からやり直します。
6. 完了したローカルファイルを開き、リモートフォルダーの一覧を再表示してください。2回目のダウンロードで異なるバイトが返った場合は、クライアントログと正確な操作を保存します。SFTPにはシェルやサーバー側のハッシュコマンドはありません。

Permission deniedは、ワークスペースのロールにSFTPまたはダウンロードへのアクセス権がないことを意味する場合があります。No such fileは存在しないパスや非表示のパスを示します。ファイルが置き換わるとキャッシュされた識別子が古くなる場合があり、古いオブジェクトが404を返したときにゲートウェイはパスを一度更新します。回数制限された読み取りではRetry-Afterに従って最大3回再試行し、一時的なGETのネットワークエラーまたは500/502/504エラーでは最大2回再試行します。

ダウンロードが成功するとローカルコピーだけが作成されます。リモートのdosyaファイルが削除、共有、変更されることはありません。クライアントが別途リモート削除を送信しない限り、ローカルでの削除はクラウドストレージに影響しません。

期待される結果

選択した保存先に完全なローカルファイルが1件あり、サイズが現在のリモート一覧と一致します。チェックサムの比較には実際にダウンロードされたバイトを使用します。元のファイルは同じdosyaワークスペースとフォルダーに残ります。

関連ガイド

• SFTPクライアントを接続
• 制限付きキーを使ってSFTPに接続