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 秘密キーのパスフレーズにアクセスする必要があります。
以下の秘密キーがサポートされています。
OpenSSHssh.comPuTTY
SSH 秘密キーのコンテンツは、複数行形式で「SSH 秘密キー」 フィールドに完全にコピー/貼り付けする必要があります。 以下は、Notepad.exe を使用して SSH 秘密キーを提供する方法のサンプル手順です。
- Notepad.exe で SSH 秘密キー ファイルを開きます。
- 編集 → すべて選択をクリックします;
- 編集 → コピーをクリックします;
- 「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 秒 |
アクション
| パスを使用してファイル コンテンツを取得する [非推奨] |
このアクションは非推奨になりました。 代わりに、パスを使用したファイル コンテンツの取得 を使用してください。
|
| パスを使用してファイル メタデータを取得する [非推奨] |
このアクションは非推奨になりました。 代わりに、パスを使用したファイル メタデータの取得 を使用してください。
|
| ファイル コンテンツを取得する [非推奨] |
このアクションは非推奨になりました。 代わりに、ファイル コンテンツの取得 を使用してください。
|
| ファイル メタデータを取得する [非推奨] |
このアクションは非推奨になりました。 代わりに、ファイル メタデータの取得 を使用してください。
|
| ファイルをコピーする [非推奨] |
このアクションは非推奨になりました。 代わりに、ファイルのコピー を使用してください。
|
| ファイルを作成する [非推奨] |
このアクションは非推奨になりました。 代わりに、ファイルの作成 を使用してください。
|
| ファイルを削除する [非推奨] |
このアクションは非推奨になりました。 代わりに、ファイルの削除 を使用してください。
|
| ファイルを更新する [非推奨] |
このアクションは非推奨になりました。 代わりに、ファイルの更新 を使用してください。
|
| フォルダーにアーカイブを抽出する [非推奨] |
このアクションは非推奨になりました。 代わりに、フォルダーにアーカイブを抽出する を使用してください。
|
| フォルダ内のファイルを一覧表示します [非推奨] |
このアクションは非推奨になりました。 代わりに フォルダー内のファイルを一覧表示する を使用してください。
|
| ルート フォルダー内のファイルを一覧表示する [非推奨] |
このアクションは非推奨になりました。 代わりに ルート フォルダー内のファイルを一覧表示する を使用してください。
|
パスを使用してファイル コンテンツを取得する [非推奨]
このアクションは非推奨になりました。 代わりに、パスを使用したファイル コンテンツの取得 を使用してください。
この操作では、ファイル パスを使用してファイル コンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル パス
|
path | True | string |
ファイルの一意のパス |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張子に基づいてコンテンツ タイプを推測します |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
パスを使用してファイル メタデータを取得する [非推奨]
このアクションは非推奨になりました。 代わりに、パスを使用したファイル メタデータの取得 を使用してください。
この操作では、ファイル パスを使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル パス
|
path | True | string |
ファイルの一意のパス |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイル コンテンツを取得する [非推奨]
このアクションは非推奨になりました。 代わりに、ファイル コンテンツの取得 を使用してください。
この操作では、ファイル ID を使用してファイル コンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイルを指定します |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張子に基づいてコンテンツ タイプを推測します |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
ファイル メタデータを取得する [非推奨]
このアクションは非推奨になりました。 代わりに、ファイル メタデータの取得 を使用してください。
この操作では、ファイル ID を使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイルを指定します |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルをコピーする [非推奨]
このアクションは非推奨になりました。 代わりに、ファイルのコピー を使用してください。
この操作では、ファイルを SFTP サーバーにコピーします。ファイルがコピーされた直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。新しく作成したファイルを削除または名前変更する前に、1 分間の間隔を置いてください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース ファイルのパス
|
source | True | string |
ソース ファイルへのパス |
|
宛先ファイルのパス
|
destination | True | string |
ファイル名を含む、宛先ファイルへのパス |
|
上書きしますか?
|
overwrite | boolean |
「true」に設定されている場合、宛先ファイルを上書きします |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルを作成する [非推奨]
このアクションは非推奨になりました。 代わりに、ファイルの作成 を使用してください。
この操作では、ファイルを SFTP サーバーにアップロードします。ファイルが作成された直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。新しく作成したファイルを削除または名前変更する前に、1 分間の間隔を置いてください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダーのパス
|
folderPath | True | string |
フォルダーの一意のパス |
|
ファイル名
|
name | True | string |
ファイルの名前 |
|
ファイル コンテンツ
|
body | True | binary |
作成するファイルのコンテンツ |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルを削除する [非推奨]
このアクションは非推奨になりました。 代わりに、ファイルの削除 を使用してください。
この操作では、ファイルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイルを指定します |
ファイルを更新する [非推奨]
このアクションは非推奨になりました。 代わりに、ファイルの更新 を使用してください。
この操作では、ファイル コンテンツを更新します。ファイルが更新された直後にサーバー上でファイルが削除/名前変更されている場合、コネクタはその設計により HTTP 404 エラーを返す場合があります。最近更新されたファイルを削除または名前変更する前に、1 分間の間隔を置いてください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル
|
id | True | string |
ファイルを指定します |
|
ファイル コンテンツ
|
body | True | binary |
更新するファイルのコンテンツ |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
フォルダーにアーカイブを抽出する [非推奨]
このアクションは非推奨になりました。 代わりに、フォルダーにアーカイブを抽出する を使用してください。
この操作では、アーカイブ ファイルをフォルダーに抽出します (例: .zip)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース アーカイブ ファイルのパス
|
source | True | string |
アーカイブ ファイルへのパス |
|
宛先フォルダー パス
|
destination | True | string |
宛先フォルダーへのパス |
|
上書きしますか?
|
overwrite | boolean |
「true」に設定されている場合、宛先ファイルを上書きします |
戻り値
フォルダ内のファイルを一覧表示します [非推奨]
このアクションは非推奨になりました。 代わりに フォルダー内のファイルを一覧表示する を使用してください。
この操作では、フォルダー内に含まれるファイルを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
id | True | string |
フォルダーを指定します |
戻り値
ルート フォルダー内のファイルを一覧表示する [非推奨]
トリガー
| ファイルが追加または変更されたとき [非推奨] |
このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき を使用してください。
|
| ファイルが追加または変更されたとき [非推奨] |
このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき (プロパティのみ) を使用してください。
|
ファイルが追加または変更されたとき [非推奨]
このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき を使用してください。
この操作では、ファイルがフォルダーに追加または変更されたときにフローをトリガーします。トリガーは、ファイルのメタデータとファイルのコンテンツの両方を取得します。トリガーは、ファイルの最終変更時刻に依存します。サードパーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。50 MB を超えるファイルは、トリガーによってスキップされます。サブフォルダーでファイルが追加/更新された場合、トリガーは起動しません。サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーを指定します |
|
ファイルのコンテンツを含める
|
includeFileContent | boolean |
true に設定した場合、ファイル コンテンツもトリガーの応答と共に取得されます |
|
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張子に基づいてコンテンツ タイプを推測します |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
ファイルが追加または変更されたとき [非推奨]
このアクションは非推奨になりました。 代わりに ファイルが追加または変更されたとき (プロパティのみ) を使用してください。
この操作では、ファイルがフォルダーに追加または変更されたときにフローをトリガーします。このトリガーは、ファイル メタデータのみを取得します。ファイル コンテンツを取得するには、「ファイル コンテンツの取得」操作を使用することができます。トリガーは、ファイルの最終変更時刻に依存します。サードパーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保存を無効にする必要があります。サブフォルダーでファイルが追加/更新された場合、トリガーは起動しません。サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
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。 |
バイナリ
これは基本的なデータ型 [バイナリ] です。