文件 API
备注
- 此 API 不适用于 Microsoft 365 云应用安全。
文件 API 提供有关存储在云应用中的文件和文件夹的元数据,例如上次修改日期、所有权等。
下面列出了支持的请求:
有关筛选器工作原理的信息,请参阅 筛选器。
下表描述了支持的筛选器:
筛选器 | 类型 | 运算符 | 说明 |
---|---|---|---|
服务 | integer | eq、neq | 从指定的 app APPID 筛选文件,例如:11770 |
实例 | integer | eq、neq | 筛选指定实例中的文件 |
fileType | integer | eq、neq | 筛选具有指定文件类型的文件。 可能的值包括: 0:其他 1:文档 2:电子表格 3:演示文稿 4:文本 5:图像 6:文件夹 |
allowDeleted | boolean | eq | 可能的值包括: true:返回已删除的文件 false 或未设置:返回未删除 (包括回收) 文件。 此值被 回收 的运算符重写 |
策略 | string | cabinetmatchedrulesequals, neq, isset, isotset | 筛选与指定策略相关的活动 |
文件名 | string | eq | 按文件名筛选文件 |
modifiedDate | 时间戳 | lte、gte、range、lte_ndays、gte_ndays | 按上次修改日期筛选文件 |
createdDate | 时间戳 | lte、gte、range | 按创建日期筛选文件 |
collaborators.entity | 实体 pk | eq、neq | 筛选与指定实体共享的文件。 例如:[{ "id": "entity-id", "inst": 0 }] |
collaborators.domains | string | eq、neq | 筛选与指定域共享的文件 |
collaborators.groups | string | eq、neq | 筛选与指定组共享的文件 |
collaborators.withDomain | string | eq、neq、deq | 筛选与指定域共享的文件 |
owner.entity | 实体 pk | eq、neq | 筛选指定实体拥有的文件。 例如:[{ "id": "entity-id", "saas": 11161, "inst": 0 }] |
owner.orgUnit | string | eq、neq | 使用指定组织单位的所有者筛选文件 |
共享 | integer | eq、neq | 筛选具有指定共享级别的文件。 可能的值包括: 4:公共 (Internet) 3:公共 2:外部 1:内部 0:专用 |
fileId | string | eq、neq | 按文件 ID 筛选文件 |
fileLabels | string | eq、neq、isset、isotset | 筛选包含指定文件标签的文件 (标记) ID |
fileScanLabels | string | eq、neq、isset、isotset | 筛选包含指定内容检查警告的文件 (标记) ID |
extension | string | eq、neq | 按给定文件扩展名筛选文件 |
mimeType | string | eq、neq | 按给定 MIME 类型筛选文件,必须是单个字符串 |
毁 | boolean | eq | 可能的值包括: true:仅返回回收的文件 false:返回非受限制的文件 |
parentFolder | folder | eq、neq | 筛选指定文件夹中包含的文件 |
folder | boolean | eq | 可能的值包括: true:仅返回文件夹 false:仅返回文件 |
隔离 | boolean | eq | 可能的值包括: true:仅返回隔离的文件 false:仅返回非隔离文件 |
snapshotLastModifiedDate | 时间戳 | lte、gte、range | 按上次修改快照日期筛选文件 |
如果你遇到任何问题,我们随时为你提供帮助。 若要获取有关产品问题的帮助或支持,请 开具支持票证。