File

文件属性

描述文件属性。

Attributes

键	Stability	Value Type	描述	Example Values
file.accessed		字符串	文件最后一次被访问的时间，格式为 ISO 8601。 [1]	2021-01-01T12:00:00Z
file.attributes		string[]	文件属性数组。 [2]	["readonly", "hidden"]
file.changed		字符串	文件属性或元数据最后一次被更改的时间，格式为 ISO 8601。 [3]	2021-01-01T12:00:00Z
file.created		字符串	文件创建的时间，格式为 ISO 8601。 [4]	2021-01-01T12:00:00Z
file.directory		字符串	文件所在的目录。如果适用，应包含驱动器号。	/home/user; C:\Program Files\MyApp
file.extension		字符串	文件扩展名，不包括前导点。 [5]	png; gz
file.fork_name		字符串	Fork 的名称。Fork 是与文件系统对象关联的附加数据。 [6]	Zone.Identifier
file.group.id		字符串	文件的主要组 ID (GID)。	1000
file.group.name		字符串	文件的主要组名。	users
file.inode		字符串	文件在文件系统中表示的 inode。	256383
file.mode		字符串	文件的模式（以八进制表示）。	0640
file.modified		字符串	文件内容最后修改的时间，格式为 ISO 8601。	2021-01-01T12:00:00Z
file.name		字符串	文件名（包括扩展名），不包括目录。	example.png
file.owner.id		字符串	文件所有者的用户 ID (UID) 或安全标识符 (SID)。	1000
file.owner.name		字符串	文件所有者的用户名。	root
file.path		字符串	文件的完整路径（包括文件名）。如果适用，应包含驱动器号。	/home/alice/example.png; C:\Program Files\MyApp\myapp.exe
file.size		int	文件大小（以字节为单位）。
file.symbolic_link.target_path		字符串	符号链接目标的路径。 [7]	/usr/bin/python3

[1] file.accessed: 某些文件系统可能不支持此属性 — 例如 NFS、FAT32、嵌入式操作系统等。

[2] file.attributes: 属性名称取决于操作系统或文件系统。以下是此属性的预期值列表（非详尽）：archive、compressed、directory、encrypted、execute、hidden、immutable、journaled、read、readonly、symbolic link、system、temporary、write。

[3] file.changed: file.changed 捕获文件属性或元数据（包括内容）更改的时间，而 file.modified 捕获文件内容修改的时间戳。

[4] file.created: 某些文件系统可能不支持此属性 — 例如 NFS、FAT32、嵌入式操作系统等。

[5] file.extension: 当文件名有多个扩展名时（例如 example.tar.gz），应只捕获最后一个（“gz”，而不是“tar.gz”）。

[6] file.fork_name: 在 Linux 上，资源 fork 用于与文件系统对象存储附加数据。一个文件总有一个用于数据部分的 fork，还可能存在其他 fork。在 NTFS 上，这类似于备用数据流 (ADS)，而文件的默认数据流称为 $DATA。Zone.Identifier 通常由 Windows 用于跟踪从 Internet 下载的内容。ADS 的形式通常是：C:\path\to\filename.extension:some_fork_name，其中 some_fork_name 是应填充 fork_name 的值。 filename.extension 应填充 file.name，而 extension 应填充 file.extension。完整路径 file.path 将包含 fork 名称。

[7] file.symbolic_link.target_path: 此属性仅适用于符号链接。