注意事項
- 此 API 不適用於 Microsoft 365 雲端應用程式安全。
Files API 提供你雲端應用程式中儲存的檔案和資料夾的元資料，例如最後修改日期、擁有權等。
以下列出了所支援的請求：
篩選
有關篩選器的運作方式，請參見 篩選器。
下表說明了所支援的過濾器：
| 篩選器 | 類型 | 運算子 | 描述 |
|---|---|---|---|
| 服務 | 整數 | EQ， neq | 來自指定應用程式 appID 的過濾檔案，例如：11770 |
| 執行個體 | 整數 | EQ， neq | 來自指定實例的過濾檔案 |
| 檔案類型 | 整數 | EQ， neq | 用指定的檔案類型來篩選檔案。 可能的值包括： 0：其他 1：文件 2：試算表 3：呈現 4：簡訊 5：影像 6：資料夾 |
| 允許已刪除 | 布林值 | 均衡器 | 可能的值包括： true：回傳已刪除的檔案 false 或 not set：回傳未刪除的 (，包括被丟棄的) 檔案。 這個值會被 trashed 運算子覆蓋 |
| 原則 | 字串陣列 | CabinetMatchedRulesequals， Neq， Isset， IsnotSet | 篩選檔案匹配及與指定政策相關的治理任務 |
| 檔名 | 字串 | 均衡器 | 依檔名篩選檔案 |
| 修改日期 | 時間戳記 | LTE、GTE、範圍、lte_ndays、gte_ndays | 依照最後修改日期篩選檔案 |
| 創建日期 | 時間戳記 | LTE、GTE、範圍 | 依照檔案建立日期篩選 |
| 協作者.實體 | 實體 PK | EQ， neq | 過濾與指定實體共用的檔案。 範例：[{ "id": "entity-id", "inst": 0 }] |
| collaborators.domains | 字串 | EQ， neq | 與指定網域共用的過濾檔案 |
| 協作者.群組 | 字串 | EQ， neq | 與指定群組共用的過濾檔案 |
| collaborators.withDomain | 字串 | 均衡、近平、微分 | 與指定網域共用的過濾檔案 |
| owner.entity | 實體 PK | EQ， neq | 由指定實體擁有的過濾檔案。 範例：[{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
| owner.orgUnit | 字串 | EQ， neq | 篩選指定組織單位擁有者檔案 |
| 共享 | 整數 | EQ， neq | 過濾指定的共享等級檔案。 可能的值包括： 4：公共 (網際網路) 3：公共 2：外部 1：內部 0：私人 |
| 檔案識別 | 字串 | EQ， neq | 以檔案 ID 篩選檔案 |
| 檔案標籤 | 字串 | 等方程、近方位、等位、非集合 | 包含指定檔案標籤 (標籤) ID 的過濾檔案 |
| 檔案掃描標籤 | 字串 | 等方程、近方位、等位、非集合 | 包含指定內容檢查警告 (標籤) ID 的過濾檔案 |
| 副檔名 | 字串 | EQ， neq | 依特定檔案副檔名過濾檔案 |
| mime類型 | 字串 | EQ， neq | 以特定 MIME 類型分類的過濾檔案，必須是單一字串 |
| 被砸爛了 | 布林值 | 均衡器 | 可能的值包括： true：只會回傳被丟棄的檔案 false：回傳未丟棄的檔案 |
| parentFolder | 檔案夾 | EQ， neq | 包含於指定資料夾中的過濾檔案 |
| 檔案夾 | 布林值 | 均衡器 | 可能的值包括： true：僅回傳資料夾 false：僅回傳檔案 |
| 隔離中 | 布林值 | 均衡器 | 可能的值包括： true：僅回傳隔離檔案 false：僅回傳未隔離檔案 |
| snapshotLastModifiedDate | 時間戳記 | LTE、GTE、範圍 | 依照快照最後修改日期來篩選檔案 |
如果你遇到任何問題，我們隨時準備協助。 若要獲得產品問題的協助或支援，請 開啟客服單。