SFTP [已棄用]
SFTP（SSH 檔案傳輸協定）是一種網路協定，可透過任何可靠的資料串流提供檔案存取、檔案傳輸和檔案管理。 它由互聯網工程任務組 （IETF） 設計，作為安全外殼協議 （SSH） 2.0 版的擴展，以提供安全的文件傳輸功能。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府（海灣合作委員會高中） - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 美國國防部 （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 | 選項→偏好設定... → 傳輸→編輯... → 保留時間戳記→停用 |
| 檔案Zilla | 傳輸→保留傳輸檔案的時間戳記→停用 |
當觸發器遇到新檔案時，它會嘗試確保新檔案完全寫入。 例如，可能正在寫入或修改檔案，且在觸發程式輪詢檔案伺服器時正在進行更新。 為了避免傳回包含部分內容的檔案，觸發程式會記下最近修改的檔案的時間戳記，但不會立即傳回這些檔案。 只有在觸發程序再次輪詢時，才會傳回這些檔案。 有時，這可能會導致延遲高達觸發輪詢間隔的兩倍。 這也表示觸發器不保證在停用「分割開啟」選項時在一次執行中傳回所有檔案。
如果要求內容，觸發器不會拾取超過 50MB 的檔案。
如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
連接器深入
有關連接器的更多資訊，請參閱 深入部分。
已知問題與限制
- 此連接器可能會將 no-op 要求傳送至後端。
一般限制
| 名稱 | 價值觀 |
|---|---|
| 每分鐘每個 SFTP 伺服器位址的請求總數上限 | 600 |
| 在頻寬時間間隔內傳輸至/從連接器傳輸的 MB 數目上限 （每個連線） | 1000 |
| 頻寬時間間隔 （以毫秒為單位） | 60000 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 主機伺服器位址 | 字串 | 主機伺服器位址 | 對 |
| 使用者名 | 字串 | 使用者名 | 對 |
| 密碼 | securestring | 密碼 | |
| SSH 私密金鑰 | securestring | SSH 私鑰（文件內容應完全按原樣提供，以多行格式提供） | |
| SSH 私密金鑰密碼 | securestring | SSH 私密金鑰密碼 （如果私密金鑰受密碼保護） | |
| 連接埠號碼 | 整數 (int) | SFTP埠號（例如：22） | |
| 停用 SSH 主機金鑰驗證 | 布爾 (bool) | 停用 SSH 主機金鑰驗證？ （對/錯） | |
| SSH 主機金鑰指紋 | 字串 | SSH 主機金鑰指紋 | |
| 停用「繼續」功能 | 布爾 (bool) | 停用恢復功能？ （對/錯） |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 使用路徑取得檔案中繼資料 [已棄用] |
此動作已被取代。 請改用 [ 使用路徑取得檔案中繼資料 ]。
|
| 使用路徑取得檔案內容 [已棄用] |
此動作已被取代。 請改用 [ 使用路徑取得檔案內容 ]。
|
| 列出根資料夾中的檔案 [已棄用] |
此動作已被取代。 請改用 列出根資料夾中的檔案 。
|
| 列出資料夾中的檔案 [已棄用] |
此動作已被取代。 請改用 列出資料夾中的檔案 。
|
| 刪除檔案 [已棄用] |
此動作已被取代。 請改用 刪除檔案 。
|
| 取得檔案中繼資料 [已淘汰] |
此動作已被取代。 請改用 取得檔案中繼資料 。
|
| 取得檔案內容 [已淘汰] |
此動作已被取代。 請改用 取得檔案內容 。
|
| 將存檔解壓縮到資料夾 [已棄用] |
此動作已被取代。 請改用 將存檔解壓縮到文件夾 。
|
| 建立檔案 [已棄用] |
此動作已被取代。 請改用 建立檔案 。
|
| 更新檔案 [已棄用] |
此動作已被取代。 請改用 更新檔案 。
|
| 複製檔案 [已棄用] |
此動作已被取代。 請改用 複製檔案 。
|
使用路徑取得檔案中繼資料 [已棄用]
此動作已被取代。 請改用 [ 使用路徑取得檔案中繼資料 ]。
此作業會使用檔案路徑取得檔案中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
檔案的唯一路徑 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
使用路徑取得檔案內容 [已棄用]
此動作已被取代。 請改用 [ 使用路徑取得檔案內容 ]。
此作業會使用檔案路徑來取得檔案內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
檔案的唯一路徑 |
|
推斷內容類型
|
inferContentType | boolean |
根據擴充功能推斷內容類型 |
傳回
檔案的內容。
- 檔案內容
- binary
列出根資料夾中的檔案 [已棄用]
列出資料夾中的檔案 [已棄用]
此動作已被取代。 請改用 列出資料夾中的檔案 。
此作業會取得資料夾中包含的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
id | True | string |
指定資料夾 |
傳回
- response
- array of BlobMetadata
刪除檔案 [已棄用]
取得檔案中繼資料 [已淘汰]
此動作已被取代。 請改用 取得檔案中繼資料 。
此作業會使用檔案識別碼取得檔案中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
指定檔案 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
取得檔案內容 [已淘汰]
此動作已被取代。 請改用 取得檔案內容 。
此作業會使用檔案識別碼取得檔案內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
指定檔案 |
|
推斷內容類型
|
inferContentType | boolean |
根據擴充功能推斷內容類型 |
傳回
檔案的內容。
- 檔案內容
- binary
將存檔解壓縮到資料夾 [已棄用]
此動作已被取代。 請改用 將存檔解壓縮到文件夾 。
此作業會將封存檔案解壓縮到資料夾中（例如：.zip）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源封存檔案路徑
|
source | True | string |
封存檔案的路徑 |
|
目的地資料夾路徑
|
destination | True | string |
目的地資料夾的路徑 |
|
覆蓋？
|
overwrite | boolean |
如果設定為 'true'，則覆寫目的地檔案 |
傳回
- response
- array of BlobMetadata
建立檔案 [已棄用]
此動作已被取代。 請改用 建立檔案 。
此作業會將檔案上傳至 SFTP 伺服器。 如果檔案在建立檔案後立即在伺服器上刪除/重新命名，則聯結器可能會根據其設計傳回HTTP 404錯誤。 請延遲 1 分鐘，然後再刪除或重新命名新建立的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾路徑
|
folderPath | True | string |
資料夾的唯一路徑 |
|
檔案名稱
|
name | True | string |
檔案名稱 |
|
檔案內容
|
body | True | binary |
要建立的檔案內容 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
更新檔案 [已棄用]
此動作已被取代。 請改用 更新檔案 。
此作業會更新檔案內容。 如果檔案在更新後立即在伺服器上刪除/重新命名，連接器可能會根據其設計傳回 HTTP 404 錯誤。 請延遲 1 分鐘，然後再刪除或重新命名最近更新的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
指定檔案 |
|
檔案內容
|
body | True | binary |
要更新的檔案內容 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
複製檔案 [已棄用]
此動作已被取代。 請改用 複製檔案 。
此作業會將檔案複製到 SFTP 伺服器。 如果檔案在複製檔案後立即在伺服器上刪除/重新命名，則連接器可能會根據其設計傳回 HTTP 404 錯誤。 請延遲 1 分鐘，然後再刪除或重新命名新建立的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源檔案路徑
|
source | True | string |
來源檔案的路徑 |
|
目的地檔案路徑
|
destination | True | string |
目的地檔案的路徑，包括檔案名稱 |
|
覆蓋？
|
overwrite | boolean |
如果設定為 'true'，則覆寫目的地檔案 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
觸發程序
| 新增或修改檔案時 [已棄用] |
此動作已被取代。 請改用新增 或修改檔案時 。
|
| 新增或修改檔案時 （僅限屬性） [已淘汰] |
此動作已被取代。 請改用新增或修改檔案時 （僅限屬性）。
|
新增或修改檔案時 [已棄用]
此動作已被取代。 請改用新增 或修改檔案時 。
當在資料夾中新增或修改檔案時，此作業會觸發流程。 觸發器將獲取文件元數據以及文件內容。 觸發程式依賴於檔案的上次修改時間。 如果檔案是由協力廠商用戶端建立，則應在用戶端中停用保留上次修改時間。 觸發程序會略過大於 50 MB 的檔案。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
指定資料夾 |
|
包含檔案內容
|
includeFileContent | boolean |
如果設定為 true，也會擷取檔案內容以及觸發程式回應 |
|
|
推斷內容類型
|
inferContentType | boolean |
根據擴充功能推斷內容類型 |
傳回
檔案的內容。
- 檔案內容
- binary
新增或修改檔案時 （僅限屬性） [已淘汰]
此動作已被取代。 請改用新增或修改檔案時 （僅限屬性）。
當在資料夾中新增或修改檔案時，此作業會觸發流程。 此觸發器只會擷取檔案中繼資料。 若要取得檔案內容，您可以使用「取得檔案內容」操作。 觸發程式依賴於檔案的上次修改時間。 如果檔案是由協力廠商用戶端建立，則應在用戶端中停用保留上次修改時間。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
選取資料夾 |
|
要從觸發程式傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 （1-100）。 請注意，「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
定義
Blob中繼資料
Blob 中繼資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
Id | string |
檔案或資料夾的唯一識別碼。 |
|
名稱
|
Name | string |
檔案或資料夾的名稱。 |
|
顯示名稱
|
DisplayName | string |
檔案或資料夾的顯示名稱。 |
|
路徑
|
Path | string |
檔案或資料夾的路徑。 |
|
最後修改
|
LastModified | date-time |
上次修改檔案或資料夾的日期和時間。 |
|
大小
|
Size | integer |
檔案或資料夾的大小。 |
|
媒體類型
|
MediaType | string |
檔案或資料夾的媒體類型。 |
|
Is資料夾
|
IsFolder | boolean |
布林值 （true、false） ，指出 Blob 是否為資料夾。 |
|
Etag
|
ETag | string |
檔案或資料夾的 etag。 |
|
檔案定位器
|
FileLocator | string |
檔案或資料夾的檔案定位器。 |
二進位
這是基本數據類型 『binary』。