SFTP - SSH
SFTP (SSH ファイル転送プロトコル) は、信頼性の高いデータ ストリーム上でファイル アクセス、ファイル転送、およびファイル管理を提供するネットワーク プロトコルです。 安全なファイル転送機能を提供するために、Secure Shell Protocol (SSH) バージョン 2.0 の拡張として、インターネット技術標準化委員会 (IETF) によって設計されました。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域および統合サービス環境 (ISE) |
| Power Automate | Standard | 以下を除くすべての Power Automate 地域 : - 米国国防総省 (DoD) |
| Power Apps | Standard | 以下を除くすべての Power Apps 地域 : - 米国国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
コネクタの攻略ガイド
この記事では、Azure Logic Apps、Power Automate、Power Apps で利用可能な SFTP-SSH マネージド コネクタのみの操作について説明します。 SFTP 組み込み コネクターは、Azure Logic Apps の Standard ロジック アプリ ワークフローでのみ利用可能です。 詳細については、 Azure Logic Apps で SSH を使用して SFTP サーバーに接続 および Azure Logic Apps の SFTP 組み込みコネクタ参照 を参照してください。
非推奨の SFTP マネージド コネクタとの違い
非推奨の SFTP マネージド コネクタ と比較して、SFTP-SSH マネージド コネクタは次の主要な機能を提供します。
.NET をサポートするオープンソースの Secure Shell (SSH) ライブラリである SSH.NET ライブラリ を使用します。
SFTP サーバー上の指定されたパスにフォルダーを作成するフォルダーの作成アクションを提供します。
SFTP サーバー上のファイルの名前を変更するファイルの名前を変更するアクションを提供します。
SFTP サーバーへの接続を最大 1 時間キャッシュします。 この機能により、パフォーマンスが向上し、コネクタがサーバーへの接続を試行する頻度が減少します。 このキャッシュ動作の期間を設定するには、SFTP サーバーの SSH 構成で ClientAliveInterval プロパティ を編集します。
認証およびアクセス許可
SFTP サーバーへの接続を作成するときは、SFTP サーバーのアドレス、アカウント資格情報、SSH 秘密鍵、およびSSH秘密キーのパスワードを提供する必要があります。 プラットフォームがチャンクを使用した大きなファイルのアップロードをサポートしている場合は、SFTP サーバーのルート フォルダーに対する 読み取りと書き込みの両方のアクセスが必要です。
SFTP-SSH コネクタは、秘密キー認証とパスワード認証の両方をサポートしています。 ただし、SFTP-SSH コネクタは、次の秘密キー形式、キー交換アルゴリズム、暗号化アルゴリズム、およびフィンガープリントのみをサポートしています。
- 秘密キー形式: OpenSSH と ssh.com 形式の両方の RSA (Rivest Shamir Adleman) および DSA (デジタル署名アルゴリズム) キー。 秘密キーが PuTTY (.ppk) ファイル形式の場合は、まずキーを OpenSSH (.pem) ファイル形式に変換 します。
- キー交換アルゴリズム: キー交換方法 - SSH.NET を確認してください。
- 暗号化アルゴリズム: 暗号化方法 - SSH.NET を確認してください。
- フィンガープリント: MD5。 詳細については、MD5 フィンガープリントを検索 を参照してください。
接続に SSH 秘密キーを提供する場合、キーを手動で入力したり編集したりしないでください。接続が失敗する可能性があります。 代わりに、必ず SSH 秘密キーファイルからキーをコピーし、そのキーを接続情報ボックスに貼り付けてください。
SSH 秘密キーを正しくコピーして貼り付けるには、次の手順に従います。
任意のテキスト エディターで SSH 秘密キー ファイルを開きます。 以下の手順では、引き続きメモ帳を例として使用します。
メモ帳の編集メニューから、すべて選択を選択します。 (Ctrl + A を押す)
編集 メニューから、コピー を選択します。
SFTP-SSH 接続情報ボックスで、完全にコピーしたキーを SSH 秘密キー プロパティに貼り付けます。これは複数行をサポートします。 キーを手動で入力または編集しないでください。
接続の詳細を入力したら、作成を選択します。
PuTTY ベース のキーを OpenSSH に変換する
PuTTY 形式と OpenSSH 形式では、異なるファイル名拡張機能が使用されます。 PuTTY 形式では、ファイル名拡張機能に .ppk または PuTTY 秘密キーが使用されます。 OpenSSH 形式では、.pem またはプライバシー強化メールのファイル名拡張機能が使用されます。 秘密キーが PuTTY 形式であり、OpenSSH 形式を使用する必要がある場合は、まず次の手順に従ってキーを OpenSSH 形式に変換します。
Unix ベースの OS
システムに PuTTY ツールがインストールされていない場合は、ここでインストールします。たとえば、次のようにします。
sudo apt-get install -y putty次のコマンドを実行すると、SFTP-SSH コネクタで使用できるファイルが作成されます。
puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>例
puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem
Windows OS
まだ行っていない場合は、最新の PuTTY ジェネレーター (puttygen.exe) ツールをダウンロード して、ツールを開きます。
PuTTY キー ジェネレーター ツール (puttygen.exe) で、アクションの読み込みを選択します。
PuTTY 形式の秘密キーファイルを参照し、開くを選択します。
変換メニューから、OpenSSH キーのエクスポートを選択します。
.pem ファイル名拡張機能を付けて秘密キー ファイルを保存します。
MD5 フィンガープリントを検索する
SFTP サーバーのフィンガープリントと予想されるフィンガープリントの両方が一致しない場合、SFTP-SSH コネクタは接続を拒否します。 コロンで区切られた 16 組の 16 進数のシーケンスである MD5 フィンガープリントを取得するには、次のオプションを試してください。
キーがあります
MD5 キーは、コロンで区切られた 47 文字の文字列です。 キーを持っているときに MD5 フィンガープリントを取得するには、ssh-keygen などのツールを使用できます。
たとえば、Bash プロンプトから次のコマンドを入力します。
ssh-keygen -l -f id_rsa.pub -E md5
キーがありません
キーがない場合に MD5 フィンガープリントを取得するには、最新の WinSCP によるサーバーとプロトコル情報ダイアログ ツール を使用するか、代わりに PuTTY 構成ツールを使用できます。
PuTTY 構成ツール (putty.exe) のカテゴリ ウィンドウで、接続 > SSH > ホスト キーを展開します。
ホスト キー アルゴリズム基本設定で、アルゴリズム選択ポリシー リストを開き、RSA が上部に表示されます。
RSA が上部で表示されない場合、RSA を選択し、RSA が上部に移動するまで、上を選択します。
PuTTY を使って SFTP サーバーに接続します。 接続が作成された後、PUTTY セキュリティ アラートが表示されたら、詳細を選択します。
注意
セキュリティ アラートが表示されない場合は、SshHostKeys エントリをクリアしてみてください。 Windows レジストリ エディターを開き、次のエントリを参照します。
Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeysPuTTY: サーバーのホスト キーに関する情報ボックスが表示されたら、MD5 フィンガープリント プロパティを検索し、47 文字の文字列値をコピーします。次の例のようになります。
**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**
トリガーの既知の問題と制限
SFTP マネージド コネクタのトリガーで、結果が欠落したり、不完全になったり、遅延したりすることがあります。
欠落している結果
SFTP トリガーは、SFTP ファイル システムをポーリングまたはチェックして、最後のポーリング以降に変更されたファイルを探すことで動作します。 SFTP マネージド コネクターは、ファイルの最終更新タイムスタンプを使用してファイルのバージョンを比較するトリガーを提供します。
現在追跡されている最終更新タイムスタンプよりも早いタイムスタンプでファイルを作成、追加、または更新した場合、SFTP マネージド コネクタのトリガーはこのファイルを検出しません。
したがって、SFTP サーバー上でファイルを作成、追加、または更新する外部ツールまたはクライアントを使用する場合は、ファイルの最終更新タイムスタンプを保持するツールまたはクライアントの機能をすべて無効にしていることを確認してください。
次の表は、このタイムスタンプを保持する一般的に使用されるツールと、この機能を無効にする手順の一覧です。
SFTP クライアント Action WinSCP オプション > 環境設定 > 移行 > 編集 > タイムスタンプを保持 > 無効にするに移動します。 FileZilla 転送 > 転送されたファイルのタイムスタンプを保持 > 無効化に移動します。 不完全、または遅れた結果
SFTP トリガーが新規作成、追加、更新されたファイルをチェックする際は、トリガーはファイルが完全であるかどうかもチェックします。 たとえば、トリガーが SFTP サーバーをチェックした際に、ファイルが変更中である場合があります。 不完全なファイルを返すのを避けるために、トリガーはファイルのタイム スタンプを記録しますが、すぐにはファイルを返しません。 その代わりに、トリガーがサーバーを再度チェックしたときにのみ、ファイルを返します。
場合によっては、この動作はトリガーのポーリング間隔の最大 2 倍の長さに及ぶ遅延を引き起こすかもしれません。 この動作により、SFTP トリガーの分割設定を無効にした場合、SFTP トリガーがすべてのファイルを同時に返さない可能性があります。
一般的な既知の問題と制限
SFTP-SSH マネージド コネクタは現在、次の SFTP サーバーをサポートしていません。
- FileMage ゲートウェイ
- Globalscape
- IBM DataPower
- MessageWay
- OpenText Secure MFT
- OpenText GXS
- Azure Blob Storage の SFTP
- VShell セキュリティーで保護されたファイル転送サーバー
ファイルの処理とアップロードには、個別の SFTP フォルダーを使用します。
処理中のファイルを監視するためのトリガーと、アップロードされたファイルを保存するためのトリガーには、SFTP サーバー上の個別のフォルダーを使用してください。 それ以外の場合は、トリガーが起動せず、予期しない動作をします。 たとえば、トリガーは、処理が必要なランダムな数のファイルをスキップする場合があります。
この制限は、これらのフォルダー間でファイルを移動する方法が必要であることを意味します。 この問題が発生した場合は、監視対象のフォルダーからファイルを削除し、別のフォルダーを使用してアップロードされたファイルを保存します。
マネージド SFTP-SSH コネクタは、アプリが存在する Azure リージョンの接続容量に基づいて、SFTP サーバーへの限られた数の接続を作成できます。 Azure Logic Apps の場合、この制限が消費ロジック アプリ ワークフローで問題を引き起こす場合は、標準ロジック アプリ ワークフローを作成し、代わりにSFTP 組み込みコネクタを使用することを考慮してください。
チャンク
Azure Logic Apps と Power Automate では、次のマネージド SFTP-SSH コネクタ アクションがチャンクをサポートしており、アクションによって大きなファイルを小さな断片で処理できるようになります。 Azure Logic Apps でのチャンクに関する詳細は、[チャンクを使用した大規模なメッセージの処理]](/azure/logic-apps/logic-apps-handle-large-messages) を参照してください。
Action チャンク サポート チャンク サイズのサポートを上書きする ファイルをコピーする 番号 該当なし ファイルを作成する イエス イエス フォルダーの作成 該当なし 該当なし ファイルを削除する 該当なし 該当なし アーカイブをフォルダに抽出します 該当なし 該当なし ファイル コンテンツの取得 イエス イエス パスを使用してファイル コンテンツを取得する イエス イエス ファイル メタデータを取得 該当なし 該当なし パスを使用してファイル メタデータを取得 該当なし 該当なし フォルダー内のファイルを一覧表示します 該当なし 該当なし ファイルの名前を変更 該当なし 該当なし ファイルを更新する 番号 該当なし チャンクをサポートする SFTP-SSH アクションは最大 1 GB のファイルを処理できますが、チャンクをサポートしない SFTP-SSH アクションは最大 50 MB のファイルを処理できます。 既定のチャンク サイズは 15 MB です。 ただし、このサイズは動的に変化する可能性があり、5 MB から始まり、最大 50 MB まで徐々に増加します。 動的なサイズ設定は、ネットワークの待ち時間、サーバーの応答時間などの要因に基づいています。
注意
統合サービス環境 (ISE) のロジック アプリの場合、このコネクタの ISE ラベル付きバージョンでは、代わりに ISE メッセージ制限 を使用するためにチャンクが必要です。
代わりに使用する一定のチャンク サイズを指定すると、この適応動作を上書きできます。 このサイズは、5 MB から 50 MB の範囲です。 たとえば、45 MB のファイルと、そのファイル サイズを待ち時間なしでサポートできるネットワークがあるとします。 アダプティブ チャンクでは、1 回の呼び出しではなく、複数回の呼び出しが発生します。 呼び出しの数を減らすには、50 MB のチャンク サイズを設定してみてください。 別のシナリオで、ロジック アプリ ワークフローがタイムアウトになる場合 (たとえば、15 MB のチャンクを使用している場合) は、サイズを 5 MB に減らしてみることができます。
チャンク サイズは接続に関連付けられています。 この属性は、チャンクをサポートするアクションとチャンクをサポートしないアクションの両方に同じ接続を使用できることを意味します。 この場合、チャンクをサポートするアクションのチャンク サイズは 5 MB から 50 MB の範囲です。
チャンクが SFTP-SSH アクションで使用する既定の適応動作を上書きするには、5 MB から 50 MB の一定のチャンク サイズを指定できます。
SFTP-SSH アクションの右上隅のデザイナーで、省略記号ボタン (...) を選択し、続いて設定を選択します。
コンテンツ転送の下のチャンク サイズ プロパティに、
5から50の整数値を入力します。完了後は、終了を選択します。
SFTP-SSH トリガーは、メッセージのチャンクをサポートしていません。 トリガーがファイル コンテンツを要求すると、15 MB 以下のファイルのみが選択されます。 15 MB を超えるファイルを取得するには、代わりに次のパターンに従います。
ファイル プロパティのみを返す SFTP-SSH トリガーを使用します。 これらのトリガーには、(プロパティのみ) という説明を含む名前が付いています。
SFTP-SSH ファイル コンテンツの取得アクションでトリガーに従います。 このアクションは、完全なファイルを読み取り、暗黙的にメッセージ チャンクを使用します。
トラブルシューティング
401 エラー: 「401 未承認」
このエラーは、正しい資格情報またはアクセス許可がないために発生する可能性があります。 詳細については、認証およびアクセス許可 を参照してください。
404 エラー: 「存在しないファイルまたはフォルダーへの参照が行われました」
このエラーは、ファイルを作成する アクションを使用したときに発生することがあります。 アクションが SFTP サーバー上にファイルを作成すると、アクションは SFTP サーバーに呼び出しを自動的に送信して、ファイルのメタデータを取得します。
呼び出しがメタデータを取得する前に、新しく作成されたファイルをすぐに移動すると、ファイルは予期された場所に存在しなくなり、存在しないファイルまたはフォルダーへの参照が行われましたという 404 エラー メッセージが表示されます。
ファイルの移動を回避または遅延できない場合は、次の手順に従って、ファイルの作成後にファイルのメタデータの読み取りをスキップできます。
ファイルを作成する アクションで、新しいパラメーターの追加リストを開き、すべてのファイル メタデータの取得プロパティを取得し、値をいいえに設定します。
後でこのファイル メタデータが必要になった場合は、ファイル メタデータの取得 アクションを使用できます。
504 エラー: 「接続先が一定期間後に適切に応答しなかったため、接続の試行に失敗したか、接続されたホストが応答しなかったために確立された接続が失敗しました」または「SFTP サーバーへの要求が '00:00:30' を超えて処理されました」
このエラーは、SFTP サーバーとの接続を正常に確立できない場合に発生することがあります。 この問題にはさまざまな理由が考えられるため、次のトラブルシューティング オプションを試してください。
接続のタイムアウトは 20 秒です。 SFTP サーバーのパフォーマンスが良好で、ファイアウォールなどの中間デバイスがオーバーヘッドを追加していないことを確認してください。
SFTP サーバーが各 IP アドレスからの接続数に制限を設けているかどうかを確認します。 このような制限は、コネクタと SFTP サーバー間の通信を妨ぎます。 この制限を必ず削除してください。
ファイアウォールを設定している場合は、地域のマネージド コネクタの IP アドレス を承認済みリストに追加してください。
エラーが断続的に発生する場合は、SFTP-SSH アクションの再試行ポリシー設定を、既定の 4 回よりも多い再試行回数に変更します。
接続確立コストを削減するには、SFTP サーバーの SSH 構成で、ClientAliveInterval プロパティを約 1 時間に増やします。
SFTP サーバー ログを確認して、SFTP サーバーに送信された呼び出しが正常に到着するかどうかを確認します。接続の問題に関する詳細情報を取得するには、ファイアウォールと SFTP サーバーでネットワーク トレースを実行することもできます。
一般的な制限
| 件名 | 価値 |
|---|---|
| 帯域幅の時間間隔内でコネクタとの間で転送されるメガバイトの最大数 (接続ごと) | 1000 |
| 帯域幅の時間間隔 (ミリ秒単位) | 60000 |
接続の作成
コネクタは、次の認証タイプをサポートしています。
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| ホスト サーバー アドレス | 文字列 | ホスト サーバー アドレス | 真 |
| ユーザー名 | 文字列 | ユーザー名 | 真 |
| パスワード | securestring | パスワード | |
| SSH 秘密キー | securestring | SSH 秘密キー (ファイルのコンテンツは、すべてそのまま複数行形式で提供する必要があります) | |
| SSH 秘密キーのパスフレーズ | securestring | SSH 秘密キーのパスフレーズ (秘密キーがパスフレーズで保護されている場合) | |
| ポート番号 | int | SFTP ポート番号 (例: 22) | |
| SSH ホスト キーの検証を無効にする | bool | SSH ホスト キーの検証を無効にしますか? (True/False) | |
| SSH ホスト キーの指紋 | 文字列 | SSH ホスト キーの指紋 | |
| ルート フォルダーのパス | 文字列 | ルート フォルダーのパス。 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 150 | 60 秒 |
アクション
| アーカイブをフォルダに抽出します |
この操作では、アーカイブ ファイルをフォルダーに展開します (例: .zip)。 |
| パスを使用してファイル コンテンツを取得 |
この操作では、ファイル パスを使用してファイル コンテンツを取得します。 |
| パスを使用してファイル メタデータを取得 |
この操作では、ファイル パスを使用してファイル メタデータを取得します。 |
| ファイル コンテンツの取得 |
この操作では、ファイル ID を使用してファイル コンテンツを取得します。 |
| ファイル メタデータを取得 |
この操作では、ファイル ID を使用してファイル メタデータを取得します。 |
| ファイルの名前を変更する |
この操作では、ファイルの名前を変更します。 |
| ファイルをコピーする |
この操作では、ファイルをコピーします。 |
| ファイルを作成する |
この操作では、ファイルをアップロードします。 |
| ファイルを削除 |
この操作では、ファイルを削除します。 |
| ファイルを更新する |
この操作では、ファイル コンテンツを更新します。 |
| フォルダーの作成 |
この操作では、新しいフォルダーを作成します。 |
| フォルダー内のファイルを一覧表示します |
この操作では、フォルダー内に含まれるファイルを取得します。 |
| ルート フォルダー内のファイルを一覧表示する |
この操作では、ルート フォルダー内のファイルを取得します。 |
アーカイブをフォルダに抽出します
この操作では、アーカイブ ファイルをフォルダーに展開します (例: .zip)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース アーカイブ ファイルのパス
|
source | True | string |
アーカイブ ファイルへのパス |
|
宛先フォルダー パス
|
destination | True | string |
宛先フォルダーへのパス |
|
上書きしますか?
|
overwrite | boolean |
「true」に設定されている場合、宛先ファイルを上書きします |
戻り値
パスを使用してファイル コンテンツを取得
この操作では、ファイル パスを使用してファイル コンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル パス
|
path | True | string |
ファイルの一意のパス |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張子に基づいてコンテンツ タイプを推測します |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
パスを使用してファイル メタデータを取得
この操作では、ファイル パスを使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル パス
|
path | True | string |
ファイルの一意のパス |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイル コンテンツの取得
この操作では、ファイル ID を使用してファイル コンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイル ID を指定します |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張子に基づいてコンテンツ タイプを推測します |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
ファイル メタデータを取得
この操作では、ファイル ID を使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイル ID を指定します |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルの名前を変更する
この操作では、ファイルの名前を変更します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイルの選択 |
|
新しい名前
|
newName | True | string |
ファイルの新しい名前 |
|
すべてのファイル メタデータの取得
|
ReadFileMetadataFromServer | boolean |
ファイルの作成が完了したら、SFTP サーバーからすべてのファイル メタデータを取得します。 これが false の場合、最終変更時刻など、一部のメタデータ プロパティが返されないことがあります。 |
戻り値
BLOB データセットのメタデータ応答を表します
- 本文
- BlobMetadataResponse
ファイルをコピーする
この操作では、ファイルをコピーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース ファイルのパス
|
source | True | string |
ソース ファイルへのパス |
|
宛先ファイルのパス
|
destination | True | string |
ファイル名を含む、宛先ファイルへのパス |
|
上書きしますか?
|
overwrite | boolean |
「true」に設定されている場合、宛先ファイルを上書きします |
|
|
すべてのファイル メタデータの取得
|
ReadFileMetadataFromServer | boolean |
ファイルの作成が完了したら、SFTP サーバーからすべてのファイル メタデータを取得します。 これが false の場合、最終変更時刻など、一部のメタデータ プロパティが返されないことがあります。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルを作成する
この操作では、ファイルをアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダーのパス
|
folderPath | True | string |
フォルダーの一意のパス |
|
ファイル名
|
name | True | string |
ファイルの名前 |
|
ファイル コンテンツ
|
body | True | binary |
作成するファイルのコンテンツ |
|
すべてのファイル メタデータの取得
|
ReadFileMetadataFromServer | boolean |
ファイルの作成が完了したら、SFTP サーバーからすべてのファイル メタデータを取得します。 これが false の場合、最終変更時刻など、一部のメタデータ プロパティが返されないことがあります。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルを削除
この操作では、ファイルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイルを指定します |
|
ファイルが見つからない場合は削除をスキップする
|
SkipDeleteIfFileNotFoundOnServer | boolean |
ファイルが存在しない場合は削除処理をスキップしてアクションを続行します。 |
ファイルを更新する
この操作では、ファイル コンテンツを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイルを指定します |
|
ファイル コンテンツ
|
body | True | binary |
更新するファイルのコンテンツ |
|
すべてのファイル メタデータの取得
|
ReadFileMetadataFromServer | boolean |
ファイルの作成が完了したら、SFTP サーバーからすべてのファイル メタデータを取得します。 これが false の場合、最終変更時刻など、一部のメタデータ プロパティが返されないことがあります。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
フォルダーの作成
この操作では、新しいフォルダーを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderPath | True | string |
フォルダーを選択する |
|
件名
|
name | True | string |
フォルダーの名前 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
フォルダー内のファイルを一覧表示します
この操作では、フォルダー内に含まれるファイルを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
id | True | string |
フォルダーを指定します |
戻り値
ルート フォルダー内のファイルを一覧表示する
トリガー
| ファイルが追加または修正されたとき |
この操作では、ファイルがフォルダー内で追加または変更されたときにフローをトリガーします。 トリガーは、ファイルのメタデータとファイルのコンテンツの両方を取得します。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。 50 MB 超えるファイルは、トリガーによってスキップされます。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 |
| ファイルが追加または変更されたとき (プロパティのみ) |
この操作では、ファイルがフォルダー内で追加または変更されたときにフローをトリガーします。 このトリガーは、ファイルのメタデータのみを取得します。 ファイル コンテンツを取得するには、「ファイル コンテンツの取得」操作を使用することができます。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 |
ファイルが追加または修正されたとき
この操作では、ファイルがフォルダー内で追加または変更されたときにフローをトリガーします。 トリガーは、ファイルのメタデータとファイルのコンテンツの両方を取得します。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。 50 MB 超えるファイルは、トリガーによってスキップされます。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーを指定します |
|
ファイルのコンテンツを含める
|
includeFileContent | boolean |
true に設定した場合、ファイル コンテンツもトリガーの応答と共に取得されます |
|
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張子に基づいてコンテンツ タイプを推測します |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
ファイルが追加または変更されたとき (プロパティのみ)
この操作では、ファイルがフォルダー内で追加または変更されたときにフローをトリガーします。 このトリガーは、ファイルのメタデータのみを取得します。 ファイル コンテンツを取得するには、「ファイル コンテンツの取得」操作を使用することができます。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーを選択する |
|
返されるファイルの数
|
maxFileCount | integer |
トリガーから返されたファイルの数 (1-100) |
戻り値
BLOB メタデータ
- ファイルの一覧
- BlobMetadata
定義
BlobMetadata
BLOB メタデータ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID
|
Id | string |
ファイルまたはフォルダーの一意 ID。 |
|
件名
|
Name | string |
ファイルまたはフォルダーの名前。 |
|
表示名
|
DisplayName | string |
ファイルまたはフォルダーの表示名。 |
|
パス
|
Path | string |
ファイルまたはフォルダーのパス。 |
|
LastModified
|
LastModified | date-time |
ファイルまたはフォルダーが最後に変更された日時です。 |
|
サイズ
|
Size | integer |
ファイルまたはフォルダーのサイズ。 |
|
MediaType
|
MediaType | string |
ファイルまたはフォルダーのメディア タイプ。 |
|
IsFolder
|
IsFolder | boolean |
BLOB がフォルダーであるかを示すブール値 (true、false)。 |
|
ETag
|
ETag | string |
ファイルまたはフォルダー ETag。 |
|
FileLocator
|
FileLocator | string |
ファイルまたはフォルダーの filelocator。 |
BlobMetadataResponse
BLOB データセットのメタデータ応答を表します
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID
|
Id | string |
ファイルまたはフォルダーの一意 ID。 |
|
件名
|
Name | string |
ファイルまたはフォルダーの名前。 |
|
表示名
|
DisplayName | string |
ファイルまたはフォルダーの表示名。 |
|
パス
|
Path | string |
ファイルまたはフォルダーのパス。 |
|
LastModified
|
LastModified | date-time |
ファイルまたはフォルダーが最後に変更された日時です。 |
|
サイズ
|
Size | integer |
ファイルまたはフォルダーのサイズ。 |
|
MediaType
|
MediaType | string |
ファイルまたはフォルダーのメディア タイプ。 |
|
IsFolder
|
IsFolder | boolean |
BLOB がフォルダーであるかを示すブール値 (true、false)。 |
|
ETag
|
ETag | string |
ファイルまたはフォルダー ETag。 |
|
FileLocator
|
FileLocator | string |
ファイルまたはフォルダーの filelocator。 |
バイナリ
これは基本的なデータ型 [バイナリ] です。