SFTP [非推奨]

  • リファレンス

SFTP (SSH ファイル転送プロトコル) は、信頼性の高いデータ ストリーム上でファイル アクセス、ファイル転送、およびファイル管理を提供するネットワーク プロトコルです。 安全なファイル転送機能を提供するために、Secure Shell Protocol (SSH) バージョン 2.0 の拡張として、インターネット技術標準化委員会 (IETF) によって設計されました。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域および統合サービス環境 (ISE):
     -   米国国防総省 (DoD)
Power Automate 標準 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC High)
     -   米国国防総省 (DoD)
Power Apps 標準 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC High)
     -   国防総省 (DoD)
連絡先
件名 Microsoft
URL Microsoft LogicApps サポート
Microsoft Power Automate サポート
Microsoft Power Apps サポート
コネクタ メタデータ
公開元 Microsoft

このコネクタは非推奨パス上にあるので、新しい SFTP-SSH コネクタを使用してください。 新しいコネクタの使用方法の詳細については、こちらを参照してください。

このコネクタを使用するには、SSH 秘密キーと SSH 秘密キーのパスフレーズにアクセスする必要があります。

以下の秘密キーがサポートされています。

  • OpenSSH
  • ssh.com
  • PuTTY

SSH 秘密キーのコンテンツは、複数行形式で「SSH 秘密キー」 フィールドに完全にコピー/貼り付けする必要があります。 以下は、Notepad.exe を使用して SSH 秘密キーを提供する方法のサンプル手順です。

  1. Notepad.exe で SSH 秘密キー ファイルを開きます。
  2. 編集 → すべて選択をクリックします;
  3. 編集 → コピーをクリックします;
  4. 「SSH秘密キー」 フィールド (接続の作成中) で、マウスの右ボタンをクリックし、貼り付けをクリックします。 「SSH秘密キー」 フィールドを手動で編集しないでください。

トリガー制限

トリガーは、SFTP ファイル システムをポーリングし、最後のポーリング以降に変更されたファイルを検索し、変更時刻ごとにファイルを比較することで機能します。 特定のツールを使用すると、ファイルの変更時刻を保持できます。 このような場合、トリガーを機能させるには、この機能を無効にする必要があります。 一般的な設定をいくつか挙げます:

SFTP クライアント 操作​​
WinSCP オプション → 基本設定… → 転送 → 編集… → タイムスタンプを保持 → 無効化
FileZilla 転送 → 転送されたファイルのタイムスタンプを保持 → 無効化

トリガーが新しいファイルを検出すると、新しいファイルが完全に書き込まれていることを確認しようとします。 たとえば、ファイルが書き込まれている、または変更されている可能性があり、トリガーがファイル サーバーをポーリングした時点で更新が行われている可能性があります。 部分的なコンテンツを含むファイルを返さないようにするために、トリガーは最近変更されたファイルのタイムスタンプを記録しますが、それらのファイルをすぐには返しません。 これらのファイルは、トリガーが再度ポーリングしたときにのみ返されます。 場合によっては、トリガーのポーリング間隔の最大 2 倍の遅延が発生することがあります。 つまり、「分割」オプションが無効になっている場合、トリガーは 1 回の実行ですべてのファイルを返すことを保証しません。

コンテンツが要求された場合、トリガーは 50MB を超えるファイルを受け取りません。

サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。

コネクタの詳細

コネクタの詳細については、詳細セクション を参照してください。

一般的な制限

名称 価値
毎分の SFTP サーバー アドレスごとのリクエスト最大総数 600
帯域幅の時間間隔内でコネクタとの間で転送されるメガバイトの最大数 (接続ごと) 1000
帯域幅の時間間隔 (ミリ秒単位) 60000

接続の作成

コネクタは、次の認証タイプをサポートしています。
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
ホスト サーバー アドレス 文字列 ホスト サーバー アドレス 真
ユーザー名 文字列 ユーザー名 真
パスワード securestring パスワード
SSH 秘密キー securestring SSH 秘密キー (ファイルのコンテンツは、すべてそのまま複数行形式で提供する必要があります)
SSH 秘密キーのパスフレーズ securestring SSH 秘密キーのパスフレーズ (秘密キーがパスフレーズで保護されている場合)
ポート番号 int SFTP ポート番号 (例: 22)
SSH ホスト キーの検証の無効化 bool SSH ホスト キーの検証を無効にしますか? (True/False)
SSH ホスト キーの指紋 文字列 SSH ホスト キーの指紋
再開機能の無効化 bool 再開機能を無効にしますか? (True/False)

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

パスを使用してファイル コンテンツを取得する [非推奨]

このアクションは非推奨になりました。 代わりに、パスを使用したファイル コンテンツの取得 を使用してください。

この操作では、ファイル パスを使用してファイル コンテンツを取得します。
パスを使用してファイル メタデータを取得する [非推奨]

このアクションは非推奨になりました。 代わりに、パスを使用したファイル メタデータの取得 を使用してください。

この操作では、ファイル パスを使用してファイル メタデータを取得します。
ファイル コンテンツを取得する [非推奨]

このアクションは非推奨になりました。 代わりに、ファイル コンテンツの取得 を使用してください。

この操作では、ファイル ID を使用してファイル コンテンツを取得します。
ファイル メタデータを取得する [非推奨]

このアクションは非推奨になりました。 代わりに、ファイル メタデータの取得 を使用してください。

この操作では、ファイル ID を使用してファイル メタデータを取得します。
ファイルをコピーする [非推奨]

このアクションは非推奨になりました。 代わりに、ファイルのコピー を使用してください。

この操作では、ファイルを SFTP サーバーにコピーします。ファイルがコピーされた直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。新しく作成したファイルを削除または名前変更する前に、1 分間の間隔を置いてください。
ファイルを作成する [非推奨]

このアクションは非推奨になりました。 代わりに、ファイルの作成 を使用してください。

この操作では、ファイルを SFTP サーバーにアップロードします。ファイルが作成された直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。新しく作成したファイルを削除または名前変更する前に、1 分間の間隔を置いてください。
ファイルを削除する [非推奨]

このアクションは非推奨になりました。 代わりに、ファイルの削除 を使用してください。

この操作では、ファイルを削除します。
ファイルを更新する [非推奨]

このアクションは非推奨になりました。 代わりに、ファイルの更新 を使用してください。

この操作では、ファイル コンテンツを更新します。ファイルが更新された直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。最近更新されたファイルを削除または名前変更する前に、1 分間の間隔を置いてください。
フォルダーにアーカイブを抽出する [非推奨]

このアクションは非推奨になりました。 代わりに、フォルダーにアーカイブを抽出する を使用してください。

この操作では、アーカイブ ファイルをフォルダーに抽出します (例: .zip)。
フォルダ内のファイルを一覧表示します [非推奨]

このアクションは非推奨になりました。 代わりに フォルダー内のファイルを一覧表示する を使用してください。

この操作では、フォルダー内に含まれるファイルを取得します。
ルート フォルダー内のファイルを一覧表示する [非推奨]

このアクションは非推奨になりました。 代わりに ルート フォルダー内のファイルを一覧表示する を使用してください。

この操作では、ルート フォルダー内のファイルを取得します。

パスを使用してファイル コンテンツを取得する [非推奨]

操作 ID:
GetFileContentByPath

このアクションは非推奨になりました。 代わりに、パスを使用したファイル コンテンツの取得 を使用してください。

この操作では、ファイル パスを使用してファイル コンテンツを取得します。

パラメーター

名前 キー 必須 型 説明
ファイル パス
 path True string

ファイルの一意のパス
コンテンツ タイプの推測
 inferContentType boolean

拡張子に基づいてコンテンツ タイプを推測します

戻り値

ファイルのコンテンツ。

ファイル コンテンツ
binary

パスを使用してファイル メタデータを取得する [非推奨]

操作 ID:
GetFileMetadataByPath

このアクションは非推奨になりました。 代わりに、パスを使用したファイル メタデータの取得 を使用してください。

この操作では、ファイル パスを使用してファイル メタデータを取得します。

パラメーター

名前 キー 必須 型 説明
ファイル パス
 path True string

ファイルの一意のパス

戻り値

BLOB メタデータ

本文​​
BlobMetadata

ファイル コンテンツを取得する [非推奨]

操作 ID:
GetFileContent

このアクションは非推奨になりました。 代わりに、ファイル コンテンツの取得 を使用してください。

この操作では、ファイル ID を使用してファイル コンテンツを取得します。

パラメーター

名前 キー 必須 型 説明
ファイル
 id True string

ファイルを指定します
コンテンツ タイプの推測
 inferContentType boolean

拡張子に基づいてコンテンツ タイプを推測します

戻り値

ファイルのコンテンツ。

ファイル コンテンツ
binary

ファイル メタデータを取得する [非推奨]

操作 ID:
GetFileMetadata

このアクションは非推奨になりました。 代わりに、ファイル メタデータの取得 を使用してください。

この操作では、ファイル ID を使用してファイル メタデータを取得します。

パラメーター

名前 キー 必須 型 説明
ファイル
 id True string

ファイルを指定します

戻り値

BLOB メタデータ

本文​​
BlobMetadata

ファイルをコピーする [非推奨]

操作 ID:
CopyFile

このアクションは非推奨になりました。 代わりに、ファイルのコピー を使用してください。

この操作では、ファイルを SFTP サーバーにコピーします。ファイルがコピーされた直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。新しく作成したファイルを削除または名前変更する前に、1 分間の間隔を置いてください。

パラメーター

名前 キー 必須 型 説明
ソース ファイルのパス
 source True string

ソース ファイルへのパス
宛先ファイルのパス
 destination True string

ファイル名を含む、宛先ファイルへのパス
上書きしますか?
 overwrite boolean

「true」に設定されている場合、宛先ファイルを上書きします

戻り値

BLOB メタデータ

本文​​
BlobMetadata

ファイルを作成する [非推奨]

操作 ID:
CreateFile

このアクションは非推奨になりました。 代わりに、ファイルの作成 を使用してください。

この操作では、ファイルを SFTP サーバーにアップロードします。ファイルが作成された直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。新しく作成したファイルを削除または名前変更する前に、1 分間の間隔を置いてください。

パラメーター

名前 キー 必須 型 説明
フォルダーのパス
 folderPath True string

フォルダーの一意のパス
ファイル名
 name True string

ファイルの名前
ファイル コンテンツ
 body True binary

作成するファイルのコンテンツ

戻り値

BLOB メタデータ

本文​​
BlobMetadata

ファイルを削除する [非推奨]

操作 ID:
DeleteFile

このアクションは非推奨になりました。 代わりに、ファイルの削除 を使用してください。

この操作では、ファイルを削除します。

パラメーター

名前 キー 必須 型 説明
ファイル
 id True string

ファイルを指定します

ファイルを更新する [非推奨]

操作 ID:
UpdateFile

このアクションは非推奨になりました。 代わりに、ファイルの更新 を使用してください。

この操作では、ファイル コンテンツを更新します。ファイルが更新された直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。最近更新されたファイルを削除または名前変更する前に、1 分間の間隔を置いてください。

パラメーター

名前 キー 必須 型 説明
ファイル
 id True string

ファイルを指定します
ファイル コンテンツ
 body True binary

更新するファイルのコンテンツ

戻り値

BLOB メタデータ

本文​​
BlobMetadata

フォルダーにアーカイブを抽出する [非推奨]

操作 ID:
ExtractFolderV2

このアクションは非推奨になりました。 代わりに、フォルダーにアーカイブを抽出する を使用してください。

この操作では、アーカイブ ファイルをフォルダーに抽出します (例: .zip)。

パラメーター

名前 キー 必須 型 説明
ソース アーカイブ ファイルのパス
 source True string

アーカイブ ファイルへのパス
宛先フォルダー パス
 destination True string

宛先フォルダーへのパス
上書きしますか?
 overwrite boolean

「true」に設定されている場合、宛先ファイルを上書きします

戻り値

応答
array of BlobMetadata

フォルダ内のファイルを一覧表示します [非推奨]

操作 ID:
ListFolder

このアクションは非推奨になりました。 代わりに フォルダー内のファイルを一覧表示する を使用してください。

この操作では、フォルダー内に含まれるファイルを取得します。

パラメーター

名前 キー 必須 型 説明
フォルダー
 id True string

フォルダーを指定します

戻り値

応答
array of BlobMetadata

ルート フォルダー内のファイルを一覧表示する [非推奨]

操作 ID:
ListRootFolder

このアクションは非推奨になりました。 代わりに ルート フォルダー内のファイルを一覧表示する を使用してください。

この操作では、ルート フォルダー内のファイルを取得します。

戻り値

応答
array of BlobMetadata

トリガー

ファイルが追加または変更されたとき [非推奨]

このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき を使用してください。

この操作では、ファイルがフォルダーに追加または変更されたときにフローをトリガーします。トリガーは、ファイルのメタデータとファイルのコンテンツの両方を取得します。トリガーは、ファイルの最終変更時刻に依存します。サードパーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。50 MB を超えるファイルは、トリガーによってスキップされます。サブフォルダーでファイルが追加/更新された場合、トリガーは起動しません。サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
ファイルが追加または変更されたとき [非推奨]

このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき (プロパティのみ) を使用してください。

この操作では、ファイルがフォルダーに追加または変更されたときにフローをトリガーします。このトリガーは、ファイル メタデータのみを取得します。ファイル コンテンツを取得するには、「ファイル コンテンツの取得」操作を使用することができます。トリガーは、ファイルの最終変更時刻に依存します。サードパーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。サブフォルダーでファイルが追加/更新された場合、トリガーは起動しません。サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。

ファイルが追加または変更されたとき [非推奨]

操作 ID:
OnUpdatedFile

このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき を使用してください。

この操作では、ファイルがフォルダーに追加または変更されたときにフローをトリガーします。トリガーは、ファイルのメタデータとファイルのコンテンツの両方を取得します。トリガーは、ファイルの最終変更時刻に依存します。サードパーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。50 MB を超えるファイルは、トリガーによってスキップされます。サブフォルダーでファイルが追加/更新された場合、トリガーは起動しません。サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。

パラメーター

名前 キー 必須 型 説明
フォルダー
 folderId True string

フォルダーを指定します
ファイルのコンテンツを含める
 includeFileContent boolean

true に設定した場合、ファイル コンテンツもトリガーの応答と共に取得されます
コンテンツ タイプの推測
 inferContentType boolean

拡張子に基づいてコンテンツ タイプを推測します

戻り値

ファイルのコンテンツ。

ファイル コンテンツ
binary

ファイルが追加または変更されたとき [非推奨]

操作 ID:
OnUpdatedFiles

このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき (プロパティのみ) を使用してください。

この操作では、ファイルがフォルダーに追加または変更されたときにフローをトリガーします。このトリガーは、ファイル メタデータのみを取得します。ファイル コンテンツを取得するには、「ファイル コンテンツの取得」操作を使用することができます。トリガーは、ファイルの最終変更時刻に依存します。サードパーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。サブフォルダーでファイルが追加/更新された場合、トリガーは起動しません。サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。

パラメーター

名前 キー 必須 型 説明
フォルダー
 folderId True string

フォルダーを選択する
トリガーにより返されるファイルの数
 maxFileCount integer

1回のトリガー実行により返されるファイルの最大数 (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。

バイナリ

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