次の方法で共有


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 コネクタは、次の秘密キー形式、キー交換アルゴリズム、暗号化アルゴリズム、およびフィンガープリントのみをサポートしています。

  • 接続に SSH 秘密キーを提供する場合、キーを手動で入力したり編集したりしないでください。接続が失敗する可能性があります。 代わりに、必ず SSH 秘密キーファイルからキーをコピーし、そのキーを接続情報ボックスに貼り付けてください。

    SSH 秘密キーを正しくコピーして貼り付けるには、次の手順に従います。

    1. 任意のテキスト エディターで SSH 秘密キー ファイルを開きます。 以下の手順では、引き続きメモ帳を例として使用します。

    2. メモ帳の編集メニューから、すべて選択を選択します。 (Ctrl + A を押す)

    3. 編集 メニューから、コピー を選択します。

    4. SFTP-SSH 接続情報ボックスで、完全にコピーしたキーを SSH 秘密キー プロパティに貼り付けます。これは複数行をサポートします。 キーを手動で入力または編集しないでください。

    5. 接続の詳細を入力したら、作成を選択します。

PuTTY ベース のキーを OpenSSH に変換する

PuTTY 形式と OpenSSH 形式では、異なるファイル名拡張機能が使用されます。 PuTTY 形式では、ファイル名拡張機能に .ppk または PuTTY 秘密キーが使用されます。 OpenSSH 形式では、.pem またはプライバシー強化メールのファイル名拡張機能が使用されます。 秘密キーが PuTTY 形式であり、OpenSSH 形式を使用する必要がある場合は、まず次の手順に従ってキーを OpenSSH 形式に変換します。

  • Unix ベースの OS

    1. システムに PuTTY ツールがインストールされていない場合は、ここでインストールします。たとえば、次のようにします。

      sudo apt-get install -y putty

    2. 次のコマンドを実行すると、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

    1. まだ行っていない場合は、最新の PuTTY ジェネレーター (puttygen.exe) ツールをダウンロード して、ツールを開きます。

    2. PuTTY キー ジェネレーター ツール (puttygen.exe) で、アクション読み込みを選択します。

    3. PuTTY 形式の秘密キーファイルを参照し、開くを選択します。

    4. 変換メニューから、OpenSSH キーのエクスポートを選択します。

    5. .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 構成ツールを使用できます。

  1. PuTTY 構成ツール (putty.exe) のカテゴリ ウィンドウで、接続 > SSH > ホスト キーを展開します。

  2. ホスト キー アルゴリズム基本設定で、アルゴリズム選択ポリシー リストを開き、RSA が上部に表示されます。

  3. RSA が上部で表示されない場合、RSA を選択し、RSA が上部に移動するまで、を選択します。

  4. PuTTY を使って SFTP サーバーに接続します。 接続が作成された後、PUTTY セキュリティ アラートが表示されたら、詳細を選択します。

    注意

    セキュリティ アラートが表示されない場合は、SshHostKeys エントリをクリアしてみてください。 Windows レジストリ エディターを開き、次のエントリを参照します。

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. PuTTY: サーバーのホスト キーに関する情報ボックスが表示されたら、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 の一定のチャンク サイズを指定できます。

    1. SFTP-SSH アクションの右上隅のデザイナーで、省略記号ボタン (...) を選択し、続いて設定を選択します。

    2. コンテンツ転送の下のチャンク サイズ プロパティに、5 から 50 の整数値を入力します。

    3. 完了後は、終了を選択します。

  • SFTP-SSH トリガーは、メッセージのチャンクをサポートしていません。 トリガーがファイル コンテンツを要求すると、15 MB 以下のファイルのみが選択されます。 15 MB を超えるファイルを取得するには、代わりに次のパターンに従います。

    1. ファイル プロパティのみを返す SFTP-SSH トリガーを使用します。 これらのトリガーには、(プロパティのみ) という説明を含む名前が付いています。

    2. SFTP-SSH ファイル コンテンツの取得アクションでトリガーに従います。 このアクションは、完全なファイルを読み取り、暗黙的にメッセージ チャンクを使用します。

トラブルシューティング​​

401 エラー: 「401 未承認」

このエラーは、正しい資格情報またはアクセス許可がないために発生する可能性があります。 詳細については、認証およびアクセス許可 を参照してください。

404 エラー: 「存在しないファイルまたはフォルダーへの参照が行われました」

このエラーは、ファイルを作成する アクションを使用したときに発生することがあります。 アクションが SFTP サーバー上にファイルを作成すると、アクションは SFTP サーバーに呼び出しを自動的に送信して、ファイルのメタデータを取得します。

呼び出しがメタデータを取得する前に、新しく作成されたファイルをすぐに移動すると、ファイルは予期された場所に存在しなくなり、存在しないファイルまたはフォルダーへの参照が行われましたという 404 エラー メッセージが表示されます。

ファイルの移動を回避または遅延できない場合は、次の手順に従って、ファイルの作成後にファイルのメタデータの読み取りをスキップできます。

  1. ファイルを作成する アクションで、新しいパラメーターの追加リストを開き、すべてのファイル メタデータの取得プロパティを取得し、値をいいえに設定します。

  2. 後でこのファイル メタデータが必要になった場合は、ファイル メタデータの取得 アクションを使用できます。

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。

バイナリ

これは基本的なデータ型 [バイナリ] です。