檔案 API
注意
- 此 API 不適用於 Microsoft 365 雲端 App 安全性。
檔案 API 提供有關儲存在雲端應用程式中之檔案和資料夾的元數據,例如上次修改日期、擁有權等等。
下列列出支援的要求:
如需篩選如何運作的資訊,請參閱 篩選。
下表描述支援的篩選條件:
篩選器 | 類型 | 運算子 | 描述 |
---|---|---|---|
服務 | 整數 | eq、neq | 篩選來自指定應用程式 appID 的檔案,例如:11770 |
執行個體 | 整數 | eq、neq | 從指定的實例篩選檔案 |
fileType | 整數 | eq、neq | 篩選具有指定檔類型的檔案。 可能的值包括: 0:其他 1:檔 2:電子表格 3:簡報 4:文字 5:影像 6:資料夾 |
allowDeleted | 布林值 | 情 商 | 可能的值包括: true:傳回已刪除的檔案 false 或未設定:傳回包含垃圾) 檔案的未刪除 (。 這個值會由 垃圾桶 運算符覆寫 |
原則 | 字串 | cabinetmatchedrulesequals, neq, isset, isotset | 篩選與指定原則相關的活動 |
檔名 | 字串 | 情 商 | 依檔名篩選檔案 |
modifiedDate | 時間戳 | lte、gte、range、lte_ndays、gte_ndays | 依上次修改檔案的日期篩選檔案 |
createdDate | 時間戳 | lte, gte, range | 依檔案的建立日期篩選檔案 |
collaborators.entity | entity pk | eq、neq | 篩選與指定實體共享的檔案。 範例:[{ "id": "entity-id", "inst": 0 }] |
collaborators.domains | 字串 | eq、neq | 篩選與指定網域共用的檔案 |
collaborators.groups | 字串 | eq、neq | 篩選與指定群組共享的檔案 |
collaborators.withDomain | 字串 | eq、neq、deq | 篩選與指定網域共用的檔案 |
owner.entity | entity pk | eq、neq | 篩選指定實體所擁有的檔案。 範例:[{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
owner.orgUnit | 字串 | eq、neq | 使用指定組織單位的擁有者篩選檔案 |
共用 | 整數 | eq、neq | 篩選具有指定共用層級的檔案。 可能的值包括: 4:公用 (因特網) 3:公用 2:外部 1:內部 0:私人 |
fileId | 字串 | eq、neq | 依檔案標識碼篩選檔案 |
fileLabels | 字串 | eq、neq、isset、isnotset | 篩選包含指定檔案標籤 (標記) 識別碼的檔案 |
fileScanLabels | 字串 | eq、neq、isset、isnotset | 篩選包含指定內容檢查警告 (標記) 標識符的檔案 |
外延 | 字串 | eq、neq | 依指定的擴展名篩選檔案 |
mimeType | 字串 | eq、neq | 依指定的 MIME 類型篩選檔案,必須是單一字串 |
毀 | 布林值 | 情 商 | 可能的值包括: true: 只傳回垃圾桶的檔案 false:傳回非內部壓縮檔案 |
parentFolder | 資料夾 | eq、neq | 篩選指定資料夾中包含的檔案 |
資料夾 | 布林值 | 情 商 | 可能的值包括: true:僅傳回資料夾 false:僅傳回檔案 |
隔離 | 布林值 | 情 商 | 可能的值包括: true:只傳回隔離的檔案 false:只傳回非四分位數的檔案 |
snapshotLastModifiedDate | 時間戳 | lte, gte, range | 依上次修改快照集的日期篩選檔案 |
如果您遇到任何問題,我們在這裡提供協助。 若要取得產品問題的協助或支援,請 開啟支援票證。