使用英语阅读

通过


文件 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 按上次修改快照日期筛选文件

如果你遇到任何问题,我们随时为你提供帮助。 若要获取有关产品问题的帮助或支持,请 开具支持票证