SFTP [非推奨]
SFTP (SSH ファイル転送プロトコル) は、信頼性の高いデータ ストリーム経由でファイル アクセス、ファイル転送、およびファイル管理を提供するネットワーク プロトコルです。 これは、セキュリティで保護されたファイル転送機能を提供するために、Secure Shell プロトコル (SSH) バージョン 2.0 の拡張機能として、インターネット エンジニアリング タスク フォース (IETF) によって設計されました。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - 米国国防総省 (DoD) |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC High) - 米国国防総省 (DoD) |
| Power Automate | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
このコネクタは非推奨のパスにあります。新しい SFTP-SSH コネクタを使用してください。 新しいコネクタの使用方法については、 こちらをご覧ください。
このコネクタを使用するには、SSH 秘密キーと SSH 秘密キーパスフレーズにアクセスする必要があります。
以下の秘密キーがサポートされています。
OpenSSHssh.comPuTTY
SSH 秘密キーの内容は、複数行形式の "SSH 秘密キー" フィールドに完全にコピーまたは貼り付ける必要があります。 Notepad.exeを使用して SSH 秘密キーを指定する方法のサンプル手順を次に示します。
- Notepad.exeで SSH 秘密キー ファイルを開きます。
- [編集] → [すべて選択] をクリックします。
- [編集] → [コピー] をクリックします。
- [SSH 秘密キー] フィールド (接続の作成時) で、マウスの右ボタンをクリックし、[貼り付け] をクリックします。 "SSH 秘密キー" フィールドは手動で編集しないでください。
トリガーの制限
トリガーは、SFTP ファイル システムをポーリングし、前回のポーリング以降に変更されたファイルを検索し、変更時間別にファイルを比較することで機能します。 特定のツールを使用すると、ファイルの変更時間を保持できます。 このような場合は、トリガーを機能させるために機能を無効にする必要があります。 一般的な設定を次に示します。
| SFTP クライアント | アクション |
|---|---|
| WinSCP | ユーザー設定→オプション... →転送→編集... → タイムスタンプを保持→無効にする |
| FileZilla | 転送→転送されたファイルのタイムスタンプを保持→無効にする |
トリガーで新しいファイルが検出されると、新しいファイルが完全に書き込まれるようにしようとします。 たとえば、ファイルの書き込みまたは変更が行われ、トリガーがファイル サーバーをポーリングした時点で更新が行われている可能性があります。 部分的なコンテンツを含むファイルが返されないようにするために、トリガーは最近変更されたファイルのタイムスタンプをメモしますが、それらのファイルはすぐには返されません。 これらのファイルは、トリガーが再度ポーリングしたときにのみ返されます。 場合によっては、トリガーのポーリング間隔の最大 2 倍の遅延が発生することがあります。 これは、"分割オン" オプションが無効になっている場合、トリガーが 1 回の実行ですべてのファイルを返すとは限らないことを意味します。
コンテンツが要求された場合、トリガーは 50 MB を超えるファイルを取得しません。
サブフォルダーにファイルが追加または更新された場合、トリガーは起動しません。 サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
コネクタの詳細
コネクタの詳細については、 詳細なセクションを参照してください。
既知の問題と制限事項
- このコネクタは、バックエンドに no-op 要求を送信する場合があります。
一般的な制限
| 名前 | 価値 |
|---|---|
| 1 分あたりの SFTP サーバー アドレスあたりの要求の最大数 | 600 |
| 帯域幅の時間間隔内でコネクタとの間で転送される最大メガバイト数 (接続ごと) | 1000 |
| 帯域幅の時間間隔 (ミリ秒単位) | 60000 |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| ホスト サーバー アドレス | 文字列 | ホスト サーバー アドレス | 正しい |
| ユーザー名 | 文字列 | ユーザー名 | 正しい |
| パスワード | securestring | パスワード | |
| SSH 秘密キー | securestring | SSH 秘密キー (ファイルの内容は、すべてマルチライン形式でそのまま提供する必要があります) | |
| SSH 秘密キーのパスフレーズ | securestring | SSH 秘密キーパスフレーズ (秘密キーがパスフレーズによって保護されている場合) | |
| ポート番号 | 整数 (int) | SFTP ポート番号 (例: 22) | |
| SSH ホスト キーの検証を無効にする | ブール (bool) | SSH ホスト キーの検証を無効にする (True/False) | |
| SSH ホスト キーのフィンガープリント | 文字列 | SSH ホスト キーのフィンガープリント | |
| 再開機能を無効にする | ブール (bool) | 再開機能を無効にする (True/False) |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| パスを使用してファイル メタデータを取得する [非推奨] |
このアクションは非推奨になりました。 代わりに 、パスを使用してファイル メタデータを取得 してください。
|
| パスを使用してファイルの内容を取得する [非推奨] |
このアクションは非推奨になりました。 代わりに パスを使用してファイルコンテンツを取得 してください。
|
| ファイル メタデータの取得 [非推奨] |
このアクションは非推奨になりました。 代わりに 、ファイル メタデータの取得 を使用してください。
|
| ファイルのコピー [非推奨] |
このアクションは非推奨になりました。 代わりに ファイルのコピー を使用してください。
|
| ファイルの作成 [非推奨] |
このアクションは非推奨になりました。 代わりに ファイルの作成 を使用してください。
|
| ファイルの内容を取得する [非推奨] |
このアクションは非推奨になりました。 代わりに 、ファイルコンテンツを取得 するを使用してください。
|
| ファイルの削除 [非推奨] |
このアクションは非推奨になりました。 代わりに 、ファイルの削除 を使用してください。
|
| ファイルの更新 [非推奨] |
このアクションは非推奨になりました。 代わりに Update ファイル を使用してください。
|
| フォルダーへのアーカイブの抽出 [非推奨] |
このアクションは非推奨になりました。 代わりに 、[アーカイブをフォルダーに抽出] を 使用してください。
|
| フォルダー内のファイルの一覧表示 [非推奨] |
このアクションは非推奨になりました。 代わりに 、フォルダー内のファイルの一覧表示 を使用してください。
|
| ルート フォルダー内のファイルを一覧表示する [非推奨] |
このアクションは非推奨になりました。 代わりに ルート フォルダーのリスト ファイル を使用してください。
|
パスを使用してファイル メタデータを取得する [非推奨]
このアクションは非推奨になりました。 代わりに 、パスを使用してファイル メタデータを取得 してください。
この操作では、ファイル パスを使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイルパス
|
path | True | string |
ファイルの一意のパス |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
パスを使用してファイルの内容を取得する [非推奨]
このアクションは非推奨になりました。 代わりに パスを使用してファイルコンテンツを取得 してください。
この操作では、ファイル パスを使用してファイルの内容を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイルパス
|
path | True | string |
ファイルの一意のパス |
|
コンテンツ タイプの推論
|
inferContentType | boolean |
拡張機能に基づいてコンテンツ タイプを推論する |
戻り値
ファイルの内容。
- ファイル コンテンツ
- binary
ファイル メタデータの取得 [非推奨]
このアクションは非推奨になりました。 代わりに 、ファイル メタデータの取得 を使用してください。
この操作では、ファイル ID を使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
ファイルを指定する |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
ファイルのコピー [非推奨]
このアクションは非推奨になりました。 代わりに ファイルのコピー を使用してください。
この操作により、ファイルが SFTP サーバーにコピーされます。 ファイルがコピーされた直後にサーバー上で削除または名前変更されている場合、コネクタは設計上 HTTP 404 エラーを返す可能性があります。 新しく作成されたファイルを削除または名前変更する前に、1 分間の遅延を使用してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース ファイルのパス
|
source | True | string |
ソース ファイルへのパス |
|
変換先ファイルのパス
|
destination | True | string |
ファイル名を含む宛先ファイルへのパス |
|
上書き。
|
overwrite | boolean |
'true' に設定されている場合、コピー先ファイルを上書きします。 |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
ファイルの作成 [非推奨]
このアクションは非推奨になりました。 代わりに ファイルの作成 を使用してください。
この操作により、ファイルが SFTP サーバーにアップロードされます。 ファイルが作成された直後にサーバー上で削除または名前変更されている場合、コネクタは設計上 HTTP 404 エラーを返す可能性があります。 新しく作成されたファイルを削除または名前変更する前に、1 分間の遅延を使用してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー パス
|
folderPath | True | string |
フォルダーの一意のパス |
|
ファイル名
|
name | True | string |
ファイルの名前 |
|
ファイル コンテンツ
|
body | True | binary |
作成するファイルの内容 |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
ファイルの内容を取得する [非推奨]
このアクションは非推奨になりました。 代わりに 、ファイルコンテンツを取得 するを使用してください。
この操作では、ファイル ID を使用してファイルの内容を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
ファイルを指定する |
|
コンテンツ タイプの推論
|
inferContentType | boolean |
拡張機能に基づいてコンテンツ タイプを推論する |
戻り値
ファイルの内容。
- ファイル コンテンツ
- binary
ファイルの削除 [非推奨]
このアクションは非推奨になりました。 代わりに 、ファイルの削除 を使用してください。
この操作により、ファイルが削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
ファイルを指定する |
ファイルの更新 [非推奨]
このアクションは非推奨になりました。 代わりに Update ファイル を使用してください。
この操作により、ファイルの内容が更新されます。 ファイルが更新された直後にサーバー上で削除または名前変更されている場合、コネクタは設計上 HTTP 404 エラーを返す可能性があります。 最近更新されたファイルを削除または名前変更する前に、1 分間の遅延を使用してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
ファイルを指定する |
|
ファイル コンテンツ
|
body | True | binary |
更新するファイルの内容 |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
フォルダーへのアーカイブの抽出 [非推奨]
このアクションは非推奨になりました。 代わりに 、[アーカイブをフォルダーに抽出] を 使用してください。
この操作により、アーカイブ ファイルがフォルダー (例: .zip) に抽出されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース アーカイブ ファイルのパス
|
source | True | string |
アーカイブ ファイルへのパス |
|
コピー先フォルダーのパス
|
destination | True | string |
コピー先フォルダーへのパス |
|
上書き。
|
overwrite | boolean |
'true' に設定されている場合、コピー先ファイルを上書きします。 |
戻り値
- response
- array of BlobMetadata
フォルダー内のファイルの一覧表示 [非推奨]
このアクションは非推奨になりました。 代わりに 、フォルダー内のファイルの一覧表示 を使用してください。
この操作では、フォルダーに含まれるファイルを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
id | True | string |
フォルダーを指定する |
戻り値
- response
- array of BlobMetadata
ルート フォルダー内のファイルを一覧表示する [非推奨]
このアクションは非推奨になりました。 代わりに ルート フォルダーのリスト ファイル を使用してください。
この操作では、ルート フォルダー内のファイルを取得します。
戻り値
- response
- array of BlobMetadata
トリガー
| ファイルが追加または変更されたとき (プロパティのみ) [非推奨] |
このアクションは非推奨になりました。 代わりに 、ファイルが追加または変更されたとき (プロパティのみ) を使用してください。
|
| ファイルが追加または変更されたとき [非推奨] |
このアクションは非推奨になりました。 代わりに ファイルが追加または変更された場合 に使用してください。
|
ファイルが追加または変更されたとき (プロパティのみ) [非推奨]
このアクションは非推奨になりました。 代わりに 、ファイルが追加または変更されたとき (プロパティのみ) を使用してください。
この操作は、フォルダー内でファイルが追加または変更されたときにフローをトリガーします。 このトリガーでは、ファイル メタデータのみがフェッチされます。 ファイルの内容を取得するには、"ファイル コンテンツの取得" 操作を使用できます。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保持を無効にする必要があります。 サブフォルダーにファイルが追加または更新された場合、トリガーは起動しません。 サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーを選択する |
|
トリガーから返されるファイルの数
|
maxFileCount | integer |
1 回のトリガー実行によって返されるファイルの最大数 (1 から 100)。 "分割オン" 設定では、トリガーが各項目を個別に処理するように強制できることに注意してください。 |
戻り値
BLOB のメタデータ
- ファイルの一覧
- BlobMetadata
ファイルが追加または変更されたとき [非推奨]
このアクションは非推奨になりました。 代わりに ファイルが追加または変更された場合 に使用してください。
この操作は、フォルダー内でファイルが追加または変更されたときにフローをトリガーします。 トリガーは、ファイル メタデータとファイルの内容の両方をフェッチします。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保持を無効にする必要があります。 50 MB を超えるファイルは、トリガーによってスキップされます。 サブフォルダーにファイルが追加または更新された場合、トリガーは起動しません。 サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーを指定する |
|
ファイルの内容を含める
|
includeFileContent | boolean |
true に設定すると、トリガーの応答と共にファイルの内容も取得されます |
|
|
コンテンツ タイプの推論
|
inferContentType | boolean |
拡張機能に基づいてコンテンツ タイプを推論する |
戻り値
ファイルの内容。
- ファイル コンテンツ
- binary
定義
BlobMetadata
BLOB のメタデータ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID (アイディー)
|
Id | string |
ファイルまたはフォルダーの一意の ID。 |
|
名前
|
Name | string |
ファイルまたはフォルダーの名前。 |
|
DisplayName
|
DisplayName | string |
ファイルまたはフォルダーの表示名。 |
|
経路
|
Path | string |
ファイルまたはフォルダーのパス。 |
|
LastModified
|
LastModified | date-time |
ファイルまたはフォルダーが最後に変更された日時。 |
|
サイズ
|
Size | integer |
ファイルまたはフォルダーのサイズ。 |
|
メディアタイプ
|
MediaType | string |
ファイルまたはフォルダーのメディアの種類。 |
|
IsFolder
|
IsFolder | boolean |
BLOB がフォルダーであるかどうかを示すブール値 (true、false)。 |
|
ETag
|
ETag | string |
ファイルまたはフォルダーの etag。 |
|
FileLocator
|
FileLocator | string |
ファイルまたはフォルダーの filelocator。 |
binary
これは基本的なデータ型 'binary' です。