檔案系統
連線到本機或網路機器上的檔案系統，以使用內部部署資料閘道讀取和寫入檔案。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 所有 Power Automate 區域 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域 |
| Power Apps | 標準 | 所有 Power Apps 區域 |
| Power Automate（自動化服務） | 標準 | 所有 Power Automate 區域 |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
連接器深度
有關連接器的更多資訊，請參閱 深入部分。
已知問題與限制
- 在某些情況下， 新增或修改檔案時 （僅限內容） 和 建立檔案時 （僅限內容） 觸發程序可能會延遲立即傳回檔案，並將新建立/修改的檔案推遲到下一個觸發程序執行。 這表示觸發程式不保證在停用「分割開啟」選項時，會在單一執行中傳回所有檔案。
一般限制
| 名稱 | 價值觀 |
|---|---|
| 一般作業的檔案大小上限 （以 MB 為單位） | 30 |
| 建立檔案作業的檔案大小上限 （以 MB 為單位） | 20 |
| 內部部署資料閘道連線逾時 （以秒為單位） | 30 |
| 在頻寬時間間隔內傳輸至/從連接器傳輸的 MB 數目上限 （每個連線） | 1000 |
| 頻寬時間間隔 （以毫秒為單位） | 60000 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 根資料夾 | 字串 | 根資料夾路徑 （範例：\MACHINE\myShare 或 C：\myShare） | 對 |
| 驗證類型 | 字串 | 連線至閘道電腦的驗證類型 | |
| 用戶名稱 | securestring | 使用者名稱認證 （例如 DOMAIN\Username） | 對 |
| 密碼 | securestring | 密碼認證 | 對 |
| Gateway | 閘道設定 | 內部部署閘道 （請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 使用路徑取得檔案中繼資料 |
此作業會使用路徑取得檔案的中繼資料。 |
| 使用路徑取得檔案內容 |
此作業會使用路徑取得檔案的內容。 |
| 列出根資料夾中的檔案 |
此作業會取得根資料夾中的檔案和子資料夾清單。 |
| 列出資料夾中的檔案 |
此作業會取得資料夾中的檔案和子資料夾清單。 |
| 刪除檔案 |
此作業會刪除檔案。 |
| 取得檔案中繼資料 |
此作業會取得檔案的中繼資料。 |
| 取得檔案內容 |
此作業會取得檔案的內容。 |
| 將存檔解壓縮到資料夾 |
此作業會將封存檔案解壓縮到資料夾中（例如：.zip）。 |
| 建立檔案 |
此作業會建立檔案。 如果檔案已存在，則會取代現有的內容。 |
| 更新檔案 |
此作業會更新檔案。 |
| 複製檔案 |
此作業會將檔案複製到檔案系統。 |
| 重新命名檔 |
此作業會重新命名檔案。 |
| 附加檔案 |
此作業會將資料附加至檔案。 |
使用路徑取得檔案中繼資料
此作業會使用路徑取得檔案的中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | 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 |
選取檔案 |
取得檔案中繼資料
取得檔案內容
此作業會取得檔案的內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
選取檔案 |
|
推斷內容類型
|
inferContentType | boolean |
根據擴充功能推斷內容類型 |
傳回
檔案的內容。
- 檔案內容
- binary
將存檔解壓縮到資料夾
此作業會將封存檔案解壓縮到資料夾中（例如：.zip）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源封存檔案路徑
|
source | True | string |
封存檔案的路徑 |
|
目的地資料夾路徑
|
destination | True | string |
目的地資料夾的路徑 |
|
覆蓋？
|
overwrite | boolean |
如果設定為 'true'，則覆寫目的地檔案 |
傳回
- response
- array of BlobMetadata
建立檔案
此作業會建立檔案。 如果檔案已存在，則會取代現有的內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾路徑
|
folderPath | True | string |
選取資料夾 |
|
檔案名稱
|
name | True | string |
檔案名稱 |
|
檔案內容
|
body | True | binary |
檔案內容 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
更新檔案
此作業會更新檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
選取檔案 |
|
檔案內容
|
body | True | binary |
檔案內容 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
複製檔案
此作業會將檔案複製到檔案系統。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源路徑
|
source | True | string |
來源檔案的路徑 |
|
目的地檔案路徑
|
destination | True | string |
目的地檔案路徑，包括目標檔案名稱 |
|
覆蓋？
|
overwrite | boolean |
如果設定為 'true，則覆寫目的地檔案 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
重新命名檔
此作業會重新命名檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
選取檔案 |
|
新名稱
|
newName | True | string |
檔案的新名稱 |
傳回
代表 Blob 資料集中繼資料回應
附加檔案
此作業會將資料附加至檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
選取檔案 |
|
檔案內容
|
body | True | binary |
要新增至檔案的內容 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
觸發程序
| 建立檔案時 （僅限屬性） |
此作業會在資料夾中建立一或多個檔案時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 |
| 新增或修改檔案時 （僅限內容） |
當資料夾中新增或修改一或多個檔案時，此作業會觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 |
建立檔案時 （僅限屬性）
此作業會在資料夾中建立一或多個檔案時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
選取資料夾 |
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 （1-100）。 請注意，「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
新增或修改檔案時 （僅限內容）
當資料夾中新增或修改一或多個檔案時，此作業會觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
選取資料夾 |
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 （1-100）。 請注意，「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
|
|
檢查建立和修改時間
|
checkBothCreatedAndModifiedDateTime | boolean |
如果旗標設定為 true，觸發程序會檢查檔案的建立日期和時間，以及檔案的上次修改日期和時間。 如果旗標設定為 false，觸發程式只會檢查檔案的上次修改日期和時間。 |
傳回
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 |
檔案或資料夾的檔案定位器。 |
BlobMetadata回應
代表 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』。