OneDrive
聯機到 OneDrive 以管理您的檔案。 您可以執行各種動作,例如上傳、更新、取得和刪除 OneDrive 中的檔案。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 : - 由 21Vianet 營運的中國雲 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - 美國國防部 (DoD) |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 : - 由 21Vianet 營運的中國雲 |
| Power Automate(自動化服務) | 標準 | 除下列區域外的所有 Power Automate 區域 : - 由 21Vianet 營運的中國雲 |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://products.office.com/onedrive/online-cloud-storage |
已知問題和限制
以下是一些已知的限制和檔案大小限制,以保護連接器的服務。 請注意,嘗試執行超出限制的操作將導致拒絕、錯誤或逾時。
如果您在使用 OneDrive 連接器將檔案轉換為流程中的 PDF 時看到錯誤 (例如「閘道錯誤」或「找不到資源」) ,則解決此問題的建議是增加檔案建立與轉換為 PDF 之間的延遲。
若要疑難排解HTML至PDF轉換的問題,請 在此處進一步瞭解。
將 存檔解壓縮至資料夾動作 的封存大小上限為 50 MB,其中包含 100 個檔案。
較大檔案的 [複製檔案] 動作可能會失敗,並出現逾時錯誤 (因為需要更長的時間才能複製較大的檔案)。 發生這種情況的大小會因服務負載而異。
此 從URL上傳檔案 動作一律會在20秒後回報成功,而不論實際結果為何。 根據檔案大小或來源下載速率,上傳過程可能需要更長的時間。 若要確定實際結果,您應該一律在流程中建立邏輯,以檢查檔案是否存在和/或逾時,再對上傳的檔案資料進行操作。
不支援跨租戶主機名稱界限存取共用檔案。 範例:contoso-my.sharepoint.com 中的使用者無法存取 microsoft-my.sharepoint.com 中的檔案
不支援多地理位置案例。 範例:contosoeu-my.sharepoint.com 中的使用者無法存取 contosoaus-my.sharepoint.com 中的檔案
某些錯誤,例如「拒絕存取」通常表示檔案已鎖定(例如,由 Excel 服務鎖定)。 此外,使用者、檔案、資料夾或租用戶可能有防止存取的原則。 如需 詳細資訊,請參閱 SharePoint/OneDrive 商務用原則頁面。
請注意,某些原則可能會阻止使用者使用部分或全部 OneDrive 連接器。 最常見的政策包括:
- (分享)防止檔案下載:OneDrive 連接器通常依賴於能夠下載檔案的內容。 「防止檔案下載」原則可能會阻止連接器下載檔案內容,因為它是資料的不受控制的外派點。
- 控制來自非受管理裝置的存取 同樣地,為了防止檔案下載,OneDrive 連接器無法驗證為受管理裝置,因為它為資料提供了不受控制的外派點。
- 根據網路位置控制對 SharePoint 和 OneDrive 資料的存取 與上述相同,OneDrive 連接器位於受信任的 Microsoft 網路上,但可以外派數據。
「 修改檔案時 」和「修改 檔案時 (僅限屬性) 」觸發程式會盡最大努力篩選無趣的修改事件 (例如修改檔案中繼資料或共用許可權的執行個體)。 不過,由於 OneDrive 本身不會提供任何明確的設施來區分不同類型的修改,因此此程式純粹是以啟發式為基礎,而且偶爾會在未發生明顯變更時觸發觸發程式。
備註
連接器無法判斷使用者何時起始檔案變更。 OneDrive 服務和應用程式可以自動在檔案中進行變更,而不需要使用者互動 (例如 Office 應用程式)。 (尤其是在使用 Office 軟體時)。 因此,您應該確定您的流程不只依賴 OneDrive 連接器的檔案變更偵測,因為觸發程式可能會比預期引發一或多次。 若要因應此行為,您的程序應該有檢查或人工核准,或使用檔案作為基本單位 (而不是檔案內的項目) 重新實作,因為「新檔案上」沒有這些限制。
- 在新檔案和修改後的檔案觸發程式 (所有變體) 上,當兩個觸發程式輪詢之間有超過 30 個擱置變更時,目前可能會發生問題。
- OneDrive 連接器不支援跨磁碟機功能。 連接器只能在用來連線至連接器的帳戶上運作,以及該帳戶所擁有的資料。 該限制包括使用添加到 Onedrive/添加快捷方式添加的文件和文件夾。
- 如果您在嘗試建立連線時收到錯誤,請確定您使用 Microsoft 個人帳戶,而不是 Microsoft 商務帳戶。
- OneDrive 連接器只會在檔案選擇器中顯示每個資料夾最多 200 個項目。 如果使用者在資料夾中有超過 200 個專案,則可能無法尋找專案。
- 基於安全性考量,「 轉換檔案 (預覽版) 」動作不支援將數位簽署、密碼保護或 IRM 限制的文件從 Microsoft Word 文件轉換為 PDF。
- 「 將封存解壓縮至資料夾 」動作不支援檔案名稱中的多位元組字元。
連接器深入
有關連接器的更多資訊,請參閱 深入部分。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 使用路徑取得檔案中繼資料 |
此作業會使用路徑取得檔案的中繼資料。 |
| 使用路徑取得檔案內容 |
此作業會使用路徑取得檔案的內容。 |
| 使用路徑移動或重新命名檔案 |
此作業會使用路徑來移動或重新命名檔案。 |
| 使用路徑複製檔案 |
此作業會依路徑複製 OneDrive 內的檔案。 |
| 使用路徑轉換檔案 (預覽版) |
此作業會使用路徑將檔案轉換成另一種格式。 支援的轉換清單可在以下網址找到: https://aka.ms/onedriveconversions |
| 依路徑建立共用連結 |
此作業會使用路徑建立檔案的共用連結。 |
| 依路徑建立共用連結 [已棄用] |
此動作已被取代。 請改用 [依路徑建立共用連結 ]。
|
| 列出根資料夾中的檔案 |
此作業會取得根資料夾中的檔案和子資料夾清單。 |
| 列出資料夾中的檔案 |
此作業會取得資料夾中的檔案和子資料夾清單。 |
| 列出資料夾中的檔案 [已棄用] |
此動作已被取代。 請改用 列出資料夾中的檔案 。
|
| 刪除檔案 |
此作業會刪除檔案。 |
| 取得檔案中繼資料 |
此作業會取得檔案的中繼資料。 |
| 取得檔案內容 |
此作業會取得檔案的內容。 |
| 取得檔案標籤 |
此作業會取得檔案的標籤。 |
| 取得檔案縮圖 |
此作業會取得檔案的縮圖。 縮略圖的有效期僅為 6 小時。 |
| 在資料夾中尋找檔案 |
此作業會使用搜尋或名稱模式比對來尋找資料夾內的檔案。 |
| 將存檔解壓縮到資料夾 |
此作業會將封存檔案解壓縮到資料夾中(例如:.zip)。 最大存檔大小為 50 MB,內部有 100 個文件。 |
| 建立共用連結 |
此作業會建立檔案的共用連結。 |
| 建立共用連結 [已棄用] |
此動作已被取代。 請改用 建立共用連結 。
|
| 建立檔案 |
此作業會建立檔案。 |
| 從 URL 上傳檔案 |
此作業會將檔案從 URL 上傳至 OneDrive。 |
| 按路徑查找文件夾中的文件 |
此作業會使用搜尋或名稱模式比對,依路徑尋找資料夾內的檔案。 |
| 新增檔案標籤 |
此作業會將標籤新增至檔案。 |
| 更新檔案 |
此作業會更新檔案。 |
| 移動或重新命名檔案 |
此作業會移動或重新命名檔案。 |
| 移除檔案標籤 |
此作業會從檔案中移除標籤。 |
| 複製檔案 |
此作業會複製 OneDrive 內的檔案。 |
| 轉換檔案 (預覽版) |
此操作會將檔案轉換為另一種格式。 支援的轉換清單可在以下網址找到: https://aka.ms/onedriveconversions |
使用路徑取得檔案中繼資料
此作業會使用路徑取得檔案的中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
檔案的唯一路徑。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
使用路徑取得檔案內容
此作業會使用路徑取得檔案的內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
檔案的唯一路徑。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 (true、false) ,用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
使用路徑移動或重新命名檔案
此作業會使用路徑來移動或重新命名檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
source | True | string |
檔案的唯一路徑。 |
|
目的地檔案路徑
|
destination | True | string |
目的地檔案路徑,包括目標檔案名稱。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true',則覆寫目的地檔案。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
使用路徑複製檔案
此作業會依路徑複製 OneDrive 內的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
source | True | string |
檔案的唯一路徑。 |
|
目的地檔案路徑
|
destination | True | string |
目的地檔案路徑,包括目標檔案名稱。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true',則覆寫目的地檔案。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
使用路徑轉換檔案 (預覽版)
此作業會使用路徑將檔案轉換成另一種格式。 支援的轉換清單可在以下網址找到: https://aka.ms/onedriveconversions
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
檔案的唯一路徑。 |
|
目標類型
|
type | string |
目標檔案類型 |
傳回
檔案的內容。
- 檔案內容
- binary
依路徑建立共用連結
此作業會使用路徑建立檔案的共用連結。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
檔案的唯一路徑。 |
|
連結類型
|
type | True | string |
連結類型 |
傳回
- 身體
- SharingLink
依路徑建立共用連結 [已棄用]
此動作已被取代。 請改用 [依路徑建立共用連結 ]。
此作業會使用路徑建立檔案的共用連結。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
檔案的唯一路徑。 |
|
連結類型
|
type | True | string |
連結類型 |
傳回
- 身體
- SharingLink
列出根資料夾中的檔案
列出資料夾中的檔案
此作業會取得資料夾中的檔案和子資料夾清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
id | True | string |
資料夾的唯一識別碼。 |
傳回
代表 Blob 中繼資料的頁面。
列出資料夾中的檔案 [已棄用]
此動作已被取代。 請改用 列出資料夾中的檔案 。
此作業會取得資料夾中的檔案和子資料夾清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
id | True | string |
資料夾的唯一識別碼。 |
|
包含子資料夾
|
includeSubfolders | boolean |
在子資料夾中包含項目 |
傳回
- response
- array of BlobMetadata
刪除檔案
此作業會刪除檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
取得檔案中繼資料
取得檔案內容
此作業會取得檔案的內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 (true、false) ,用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
取得檔案標籤
取得檔案縮圖
此作業會取得檔案的縮圖。 縮略圖的有效期僅為 6 小時。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
縮圖大小
|
size | True | string |
要擷取的縮圖大小。 |
傳回
縮圖回應資料
- 身體
- Thumbnail
在資料夾中尋找檔案
此作業會使用搜尋或名稱模式比對來尋找資料夾內的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋查詢
|
query | True | string |
要使用的搜尋查詢 |
|
資料夾
|
id | True | string |
資料夾的唯一識別碼。 |
|
檔案搜尋模式
|
findMode | True | string |
要使用的搜尋方法。 「搜尋」模式使用搜尋查詢(類似於普通搜尋引擎)搜尋您的 OneDrive。 當選取「正則運算式模式比對」模式時,搜尋查詢會被視為正則表達式模式,並傳回名稱符合查詢的檔案 |
|
要傳回的檔案數目
|
maxFileCount | integer |
要傳回的檔案數目上限 (1-100) |
傳回
- response
- array of BlobMetadata
將存檔解壓縮到資料夾
此作業會將封存檔案解壓縮到資料夾中(例如:.zip)。 最大存檔大小為 50 MB,內部有 100 個文件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源封存檔案路徑
|
source | True | string |
封存檔案的路徑。 |
|
目的地資料夾路徑
|
destination | True | string |
擷取封存內容的路徑。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true',則覆寫目的地檔案。 |
傳回
- response
- array of BlobMetadata
建立共用連結
此作業會建立檔案的共用連結。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
連結類型
|
type | True | string |
連結類型 |
傳回
- 身體
- SharingLink
建立共用連結 [已棄用]
此動作已被取代。 請改用 建立共用連結 。
此作業會建立檔案的共用連結。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
連結類型
|
type | True | string |
連結類型 |
傳回
- 身體
- SharingLink
建立檔案
此作業會建立檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾路徑
|
folderPath | True | string |
資料夾的唯一路徑。 |
|
檔案名稱
|
name | True | string |
檔案的檔名。 OneDrive 不允許某些字元,並將以底線取代。 |
|
檔案內容
|
body | True | binary |
檔案的內容。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
從 URL 上傳檔案
此作業會將檔案從 URL 上傳至 OneDrive。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源網址
|
source | True | string |
來源檔案的 URL。 |
|
目的地檔案路徑
|
destination | True | string |
目的地檔案路徑,包括目標檔案名稱。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true',則覆寫目的地檔案。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
按路徑查找文件夾中的文件
此作業會使用搜尋或名稱模式比對,依路徑尋找資料夾內的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋查詢
|
query | True | string |
要使用的搜尋查詢 |
|
資料夾路徑
|
path | True | string |
資料夾的唯一路徑。 |
|
檔案搜尋模式
|
findMode | True | string |
要使用的搜尋方法。 「搜尋」模式使用搜尋查詢(類似於普通搜尋引擎)搜尋您的 OneDrive。 當選取「正則運算式模式比對」模式時,搜尋查詢會被視為正則表達式模式,並傳回名稱符合查詢的檔案 |
|
要傳回的檔案數目
|
maxFileCount | integer |
要傳回的檔案數目上限 (1-100) |
傳回
- response
- array of BlobMetadata
新增檔案標籤
此作業會將標籤新增至檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
標記
|
tag | True | string |
標籤的名稱。 |
傳回
Tags
- 身體
- Tags
更新檔案
此作業會更新檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
檔案內容
|
body | True | binary |
檔案的內容。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
移動或重新命名檔案
此作業會移動或重新命名檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
目的地檔案路徑
|
destination | True | string |
目的地檔案路徑,包括目標檔案名稱。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true',則覆寫目的地檔案。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
移除檔案標籤
此作業會從檔案中移除標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
標記
|
tag | True | string |
標籤的名稱。 |
複製檔案
此作業會複製 OneDrive 內的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
目的地檔案路徑
|
destination | True | string |
目的地檔案路徑,包括目標檔案名稱。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true',則覆寫目的地檔案。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
轉換檔案 (預覽版)
此操作會將檔案轉換為另一種格式。 支援的轉換清單可在以下網址找到: https://aka.ms/onedriveconversions
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案
|
id | True | string |
檔案的唯一識別碼。 |
|
目標類型
|
type | string |
目標檔案類型 |
傳回
檔案的內容。
- 檔案內容
- binary
觸發程序
| 修改檔案時 |
當資料夾中的檔案被修改時,此作業會觸發流程。 大於 50 MB 的檔案將被略過,並且不會由此觸發程序傳回。 |
| 修改檔案時 [已棄用] |
此動作已被取代。 請改用修改 檔案時 。
|
| 修改檔案時 (僅限內容) |
當資料夾中的檔案被修改時,此作業會觸發流程。 |
| 修改檔案時 (僅限屬性) [已棄用] |
此動作已被取代。 請改用 When a file is modified (僅限屬性)。
|
| 刪除檔案時 (僅限屬性) |
當從資料夾中刪除檔案時,此作業會觸發流程。 |
| 建立檔案時 |
此作業會在資料夾中建立新檔案時觸發流程。 大於 50 MB 的檔案將被略過,並且不會由此觸發程序傳回。 在 OneDrive 內移動的檔案不會被視為新檔案。 |
| 建立檔案時 [已棄用] |
此動作已被取代。 請改用建立 檔案時 。
|
| 建立檔案時 (僅限屬性) |
此作業會在資料夾中建立新檔案時觸發流程。 在 OneDrive 內移動的檔案不會被視為新檔案。 |
| 建立檔案時 (僅限屬性) [已棄用] |
此動作已被取代。 請改用建立檔案時 (僅限屬性)。
|
修改檔案時
當資料夾中的檔案被修改時,此作業會觸發流程。 大於 50 MB 的檔案將被略過,並且不會由此觸發程序傳回。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
包含子資料夾
|
includeSubfolders | boolean |
在子資料夾中包含項目 |
|
|
推斷內容類型
|
inferContentType | boolean |
布林值 (true、false) ,用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
修改檔案時 [已棄用]
此動作已被取代。 請改用修改 檔案時 。
當資料夾中的檔案被修改時,此作業會觸發流程。 大於 50 MB 的檔案將被略過,並且不會由此觸發程序傳回。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 (true、false) ,用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
修改檔案時 (僅限內容)
當資料夾中的檔案被修改時,此作業會觸發流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
包含子資料夾
|
includeSubfolders | boolean |
在子資料夾中包含項目 |
|
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 (1-100)。 請注意,「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
修改檔案時 (僅限屬性) [已棄用]
此動作已被取代。 請改用 When a file is modified (僅限屬性)。
當資料夾中的檔案被修改時,此作業會觸發流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 (1-100)。 請注意,「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
刪除檔案時 (僅限屬性)
當從資料夾中刪除檔案時,此作業會觸發流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
包含子資料夾
|
includeSubfolders | boolean |
在子資料夾中包含項目 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
建立檔案時
此作業會在資料夾中建立新檔案時觸發流程。 大於 50 MB 的檔案將被略過,並且不會由此觸發程序傳回。 在 OneDrive 內移動的檔案不會被視為新檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
包含子資料夾
|
includeSubfolders | boolean |
在子資料夾中包含項目 |
|
|
推斷內容類型
|
inferContentType | boolean |
布林值 (true、false) ,用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
建立檔案時 [已棄用]
此動作已被取代。 請改用建立 檔案時 。
此作業會在資料夾中建立新檔案時觸發流程。 大於 50 MB 的檔案將被略過,並且不會由此觸發程序傳回。 在 OneDrive 內移動的檔案不會被視為新檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 (true、false) ,用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
建立檔案時 (僅限屬性)
此作業會在資料夾中建立新檔案時觸發流程。 在 OneDrive 內移動的檔案不會被視為新檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
包含子資料夾
|
includeSubfolders | boolean |
在子資料夾中包含項目 |
|
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 (1-100)。 請注意,「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
建立檔案時 (僅限屬性) [已棄用]
此動作已被取代。 請改用建立檔案時 (僅限屬性)。
此作業會在資料夾中建立新檔案時觸發流程。 在 OneDrive 內移動的檔案不會被視為新檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 (1-100)。 請注意,「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
定義
Blob中繼資料
Blob 中繼資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
Id | string |
檔案或資料夾的唯一識別碼。 |
|
名稱
|
Name | string |
檔案或資料夾的名稱。 |
|
名稱不帶副檔名
|
NameNoExt | string |
檔案或資料夾的名稱,不含副檔名。 |
|
顯示名稱
|
DisplayName | string |
檔案或資料夾的顯示名稱。 |
|
路徑
|
Path | string |
檔案或資料夾的路徑。 |
|
上次修改時間
|
LastModified | date-time |
上次修改檔案或資料夾的日期和時間。 |
|
大小
|
Size | integer |
檔案或資料夾大小 (以位元組為單位)。 |
|
媒體類型
|
MediaType | string |
檔案或資料夾的媒體類型。 |
|
是文件夾嗎?
|
IsFolder | boolean |
布林值 (true、false) ,指出 Blob 是否為資料夾。 |
|
Etag
|
ETag | string |
檔案或資料夾的 etag。 |
|
檔案定位器
|
FileLocator | string |
檔案或資料夾的檔案定位器。 |
|
上次修改者
|
LastModifiedBy | string |
上次修改檔案或資料夾的使用者。 |
分享連結
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
網址
|
WebUrl | string |
指向檔案或資料夾的 URL。 |
Tags
Tags
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Tags
|
Tags | array of string |
標籤清單。 |
縮圖
縮圖回應資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
網址
|
Url | string |
指向縮圖的 URL。 |
|
寬度
|
Width | integer |
縮圖寬度 (以像素為單位)。 |
|
高度
|
Height | integer |
縮圖高度(以像素為單位)。 |
BlobMetadataPage
代表 Blob 中繼資料的頁面。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of BlobMetadata |
Blob 中繼資料收集。 |
|
nextLink
|
nextLink | string |
可用來擷取下一頁的URL。 |
二進位
這是基本資料類型「二進位」。