盒子
Box™ 是一項確保您的文件安全、同步且易於共享的服務。 連接到 Box 以管理您的文件。 您可以在 Box 中執行各種操作，例如上傳、更新、取得和刪除檔案。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 由 21Vianet 營運的中國雲 |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://www.box.com/ |
| 隱私策略 | https://www.box.com/legal/privacypolicy |
Box API 狀態
請使用此資源來追蹤 Box API 中斷
已知問題與限制
- 連接器不支援單一登入 （SSO） 連線，請改用標準連線。
- 請勿將 「檔案識別碼」 參數與實際 檔案名稱混淆。 由於 Box REST API 限制，包含下列字元 [\ { } “ <>] 的無效檔案識別碼可能會導致連接器 GetawayTimeout 錯誤。
- 指定路徑 （資料夾路徑 或 檔案路徑） 中的每個資料夾 （包括根資料夾） 不得包含超過 10000 個項目。
- 使用檔案選擇器選擇資料夾的檔案時，產生的路徑可能以「//所有檔案」開頭，例如「//所有檔案/我的資料夾/MyFile.txt」。 為避免在根目錄下建立新的「所有檔案」資料夾，應手動將此路徑變更為「/我的資料夾/MyFile.txt」。 對於引用根文件夾，請使用單個斜線，例如 '//所有文件' -> '/'。
- 在大多數情況下，觸發器幾乎會在對應事件發生時立即觸發，但在極少數情況下，由於基礎 API 限制，觸發器延遲觸發可能需要長達一天的時間。 若要深入瞭解，請前往 （Box 事件 API）。 建議在這段時間內將檔案保留在資料夾中。 否則，觸發邏輯將不會報告。
- 如果檔案已存在於資料夾中，則以相同名稱重新上傳的檔案將不會被視為建立事件，而是更新事件。
- 此連接器不再是表格式連接器，因此不能用作表格式資料來源 - 包括 Excel 連接器。
- 此連接器可能會將 no-op 要求傳送至後端。
一般限制
| 名稱 | 價值觀 |
|---|---|
| 檔案大小上限 （以 MB 為單位） | 75 |
| 資料夾項目數目上限 | 10000 |
| 在頻寬時間間隔內傳輸至/從連接器傳輸的 MB 數目上限 （每個連線） | 1000 |
| 頻寬時間間隔 （以毫秒為單位） | 60000 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 使用 id 取得檔案中繼資料 |
使用檔案識別碼從 Box 擷取檔案中繼資料。 |
| 使用 id 取得檔案內容 |
使用 id 從 Box 擷取檔案內容。 |
| 使用路徑取得檔案中繼資料 |
使用路徑從 Box 擷取檔案中繼資料。 |
| 使用路徑取得檔案內容 |
使用路徑從 Box 擷取檔案內容。 |
| 列出根資料夾中的檔案和資料夾 |
列出 Box 根資料夾中的檔案和資料夾。 |
| 列出資料夾中的檔案和資料夾 |
列出 Box 資料夾中的檔案和資料夾。 |
| 刪除檔案 |
從 Box 中刪除現有檔案。 |
| 將存檔解壓縮到資料夾 |
將封存檔案解壓縮到 Box 中的資料夾中 （例如：.zip）。 |
| 建立檔案 |
將檔案上傳至 Box。 |
| 更新檔案 |
更新 Box 中的現有檔案。 |
| 複製檔案 |
將檔案複製到 Box 中的檔案路徑。 |
使用 id 取得檔案中繼資料
使用檔案識別碼從 Box 擷取檔案中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案標識碼
|
id | True | string |
Box 中檔案的唯一識別碼。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
使用 id 取得檔案內容
使用 id 從 Box 擷取檔案內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案標識碼
|
id | True | string |
Box 中檔案的唯一識別碼。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 （true、false） ，用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
使用路徑取得檔案中繼資料
使用路徑從 Box 擷取檔案中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
Box 中檔案的唯一路徑。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
使用路徑取得檔案內容
使用路徑從 Box 擷取檔案內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案路徑
|
path | True | string |
Box 中檔案的唯一路徑。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 （true、false） ，用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
列出根資料夾中的檔案和資料夾
列出資料夾中的檔案和資料夾
列出 Box 資料夾中的檔案和資料夾。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾識別碼
|
id | True | string |
Box 中資料夾的唯一識別碼。 |
傳回
- response
- array of BlobMetadata
刪除檔案
從 Box 中刪除現有檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案標識碼
|
id | True | string |
要從 Box 刪除的檔案的唯一識別碼。 |
將存檔解壓縮到資料夾
將封存檔案解壓縮到 Box 中的資料夾中 （例如：.zip）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源封存檔案路徑
|
source | True | string |
封存檔案的路徑。 |
|
目的地資料夾路徑
|
destination | True | string |
Box 中用於提取存檔內容的路徑。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true'，則覆寫目的地檔案。 |
傳回
- response
- array of BlobMetadata
建立檔案
將檔案上傳至 Box。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾路徑
|
folderPath | True | string |
將檔案上傳至 Box 的資料夾路徑。 |
|
檔案名稱
|
name | True | string |
要在 Box 中建立的檔案名稱。 |
|
檔案內容
|
body | True | binary |
要上傳至 Box 的檔案內容。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
更新檔案
更新 Box 中的現有檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案標識碼
|
id | True | string |
要在 Box 中更新的檔案的唯一識別碼。 |
|
檔案內容
|
body | True | binary |
要在 Box 中更新的檔案內容。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
複製檔案
將檔案複製到 Box 中的檔案路徑。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
來源網址
|
source | True | string |
來源檔案的 URL。 |
|
目的地檔案路徑
|
destination | True | string |
Box 中的目的地檔案路徑，包括目標檔案名稱。 |
|
改寫
|
overwrite | boolean |
如果設定為 'true'，則覆寫目的地檔案。 |
傳回
Blob 中繼資料
- 身體
- BlobMetadata
觸發程序
| 修改檔案時 [已棄用] |
當 Box 資料夾中的檔案被修改時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 |
| 修改檔案時 （僅限內容） |
當資料夾中的檔案被修改時，此作業會觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 |
| 修改檔案時 （僅限屬性） （V2） （預覽版） |
當資料夾中的檔案被修改時，此作業會觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 如果關閉觸發器>設定的「分割開啟」選項，則成功的觸發器執行可能會為「檔案清單」輸出產生空陣列。 |
| 建立檔案時 [已棄用] |
在 Box 資料夾中建立新檔案時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 |
| 建立檔案時 （僅限屬性） [已棄用] |
此動作已被取代。 請改用建立檔案時 （僅限屬性） （V2）。
|
| 建立檔案時 （僅限屬性） （V2） |
此作業會在資料夾中建立新檔案時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 如果關閉觸發器>設定的「分割開啟」選項，則成功的觸發器執行可能會為「檔案清單」輸出產生空陣列。 |
修改檔案時 [已棄用]
當 Box 資料夾中的檔案被修改時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾識別碼
|
folderId | True | string |
Box 中資料夾的唯一識別碼。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 （true、false） ，用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
修改檔案時 （僅限內容）
當資料夾中的檔案被修改時，此作業會觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
選取資料夾 |
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 （1-100）。 請注意，「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
修改檔案時 （僅限屬性） （V2） （預覽版）
當資料夾中的檔案被修改時，此作業會觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 如果關閉觸發器>設定的「分割開啟」選項，則成功的觸發器執行可能會為「檔案清單」輸出產生空陣列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
選取資料夾 |
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 （1-100）。 請注意，「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
建立檔案時 [已棄用]
在 Box 資料夾中建立新檔案時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾識別碼
|
folderId | True | string |
Box 中資料夾的唯一識別碼。 |
|
推斷內容類型
|
inferContentType | boolean |
布林值 （true、false） ，用於根據副檔名推斷內容類型。 |
傳回
檔案的內容。
- 檔案內容
- binary
建立檔案時 （僅限屬性） [已棄用]
此動作已被取代。 請改用建立檔案時 （僅限屬性） （V2）。
此作業會在資料夾中建立新檔案時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾
|
folderId | True | string |
資料夾的唯一識別碼。 |
|
要傳回的檔案數目
|
maxFileCount | integer |
單一觸發程式執行要傳回的檔案數目上限 （1-100）。 請注意，「分割開啟」設定可以強制觸發器單獨處理每個項目。 |
傳回
Blob 中繼資料
- 檔案清單
- BlobMetadata
建立檔案時 （僅限屬性） （V2）
此作業會在資料夾中建立新檔案時觸發流程。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。 如果關閉觸發器>設定的「分割開啟」選項，則成功的觸發器執行可能會為「檔案清單」輸出產生空陣列。
參數
| 名稱 | 機碼 | 必要 | 類型 | 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 |
檔案或資料夾的檔案定位器。 |
|
最後修改者
|
LastModifiedBy | string |
上次修改檔案或資料夾的使用者。 |
二進位
這是基本數據類型 『binary』。