事件

介绍

事件是有关 Incus 上发生的行动的消息。使用 API 端点 /1.0/events 直接或通过 incus monitor 将连接到 WebSocket，通过该 WebSocket 将流式传输日志和生命周期消息。

事件类型

Incus 目前支持三种事件类型。

• logging：显示所有日志消息，无论服务器日志级别如何。

• operation：显示所有正在进行的操作，从创建到完成（包括其状态和进度元数据的更新）。

• lifecycle：显示有关 Incus 上发生的特定行动的审计跟踪。

事件结构

示例

location: cluster_name
metadata:
  action: network-updated
  requestor:
    protocol: unix
    username: root
  source: /1.0/networks/incusbr0
timestamp: "2021-03-14T00:00:00Z"
type: lifecycle

• location：集群成员名称（如果集群化）。

• timestamp：事件发生的 RFC3339 格式时间。

• type：此事件的类型（logging、operation 或 lifecycle 中的一种）。

• metadata：有关特定事件类型的的信息。

日志事件结构

• message：日志消息。

• level：日志的日志级别。

• context：包含在事件中的其他信息。

操作事件结构

• id：操作的 UUID。

• class：操作的类型（task、token 或 websocket）。

• description：操作的描述。

• created_at：操作的创建时间。

• updated_at：操作的上次修改时间。

• status：操作的当前状态。

• status_code：操作状态代码。

• resources：受此操作影响的资源。

• metadata：操作特定的元数据。

• may_cancel：是否可以取消操作。

• err：操作的错误消息。

• location：集群成员名称（如果集群化）。

生命周期事件结构

• action：发生的生命周期行动。

• requestor：有关谁正在发出请求的信息（如果适用）。

• source：正在执行的操作的路径。

• context：包含在事件中的其他信息。

支持的生命周期事件

名称	描述	附加信息
certificate-created	已将新证书添加到服务器信任存储中。
certificate-deleted	已从信任存储中删除证书。
certificate-updated	已更新证书的配置。
cluster-certificate-updated	整个集群的证书已更改。
cluster-disabled	已为这台机器禁用集群功能。
cluster-enabled	已为这台机器启用集群功能。
cluster-group-created	已创建一个新的集群组。
cluster-group-deleted	已删除一个集群组。
cluster-group-renamed	已重命名一个集群组。
cluster-group-updated	已更新一个集群组。
cluster-member-added	一台新机器已加入集群。
cluster-member-removed	已从集群中删除集群成员。
cluster-member-renamed	已重命名集群成员。	old_name：之前的名称。
cluster-member-updated	已编辑集群成员的配置。
cluster-token-created	已创建用于添加集群成员的加入令牌。
config-updated	服务器配置已更改。
image-alias-created	已为现有镜像创建别名。	target：原始实例。
image-alias-deleted	已删除现有镜像的别名。	target：原始实例。
image-alias-renamed	已重命名现有镜像的别名。	old_name：之前的名称。
image-alias-updated	镜像别名的配置已更改。	target：原始实例。
image-created	已将新镜像添加到镜像存储中。	type: container 或 vm。
image-deleted	镜像已从镜像存储中删除。
image-refreshed	本地镜像副本已更新到当前源镜像版本。
image-retrieved	原始镜像文件已从服务器下载。	target: 目标服务器。
image-secret-created	已创建用于获取此镜像的一次性密钥。
image-updated	镜像的配置已更改。
instance-backup-created	已创建实例备份。
instance-backup-deleted	实例备份已删除。
instance-backup-renamed	实例备份已重命名。	old_name：之前的名称。
instance-backup-retrieved	原始实例备份文件已下载。
instance-console	已连接到实例的控制台。	type: console 或 vga。
instance-console-reset	控制台缓冲区已重置。
instance-console-retrieved	控制台日志已下载。
instance-created	已创建新实例。
instance-deleted	实例已删除。
instance-exec	已在实例上执行命令。	command: 要执行的命令。
instance-file-deleted	实例上的文件已删除。	file: 文件路径。
instance-file-pushed	文件已推送到实例。	file-source: 本地文件路径。 file-destination: 目标文件路径。 info: 文件信息。
instance-file-retrieved	文件已从实例下载。	file-source: 实例文件路径。 file-destination: 目标文件路径。
instance-log-deleted	实例的指定日志文件已删除。
instance-log-retrieved	实例的指定日志文件已下载。
instance-metadata-retrieved	实例的镜像元数据已下载。
instance-metadata-template-created	已创建实例的新镜像模板文件。	path: 相对文件路径。
instance-metadata-template-deleted	实例的镜像模板文件已删除。	path: 相对文件路径。
instance-metadata-template-retrieved	实例的镜像模板文件已下载。	path: 相对文件路径。
instance-metadata-updated	实例的镜像元数据已更改。
instance-paused	实例已处于暂停状态。
instance-ready	实例已准备就绪。
instance-renamed	实例已重命名。	old_name：之前的名称。
instance-restarted	实例已重启。
instance-restored	实例已从快照中恢复。	snapshot: 正在恢复的快照的名称。
instance-resumed	实例已在暂停后恢复。
instance-shutdown	实例已关闭。
instance-snapshot-created	已创建实例的快照。
instance-snapshot-deleted	实例快照已删除。
instance-snapshot-renamed	实例快照已重命名。	old_name：之前的名称。
instance-snapshot-updated	实例快照的配置已更改。
instance-started	实例已启动。
instance-stopped	实例已停止。
instance-updated	实例的配置已更改。
network-acl-created	已创建新的网络 ACL。
network-acl-deleted	网络 ACL 已删除。
network-acl-renamed	网络 ACL 已重命名。	old_name：之前的名称。
network-acl-updated	网络 ACL 配置已更改。
network-created	已创建网络设备。
network-deleted	网络设备已删除。
network-forward-created	已创建新的网络转发。
network-forward-deleted	网络转发已删除。
network-forward-updated	网络转发已更新。
network-peer-created	已创建新的网络对等体。
network-peer-deleted	网络对等体已删除。
network-peer-updated	网络对等体已更新。
network-renamed	网络设备已重命名。	old_name：之前的名称。
network-updated	网络设备的配置已更改。
network-zone-created	已创建新的网络区域。
network-zone-deleted	网络区域已删除。
network-zone-record-created	已创建新的网络区域记录。
network-zone-record-deleted	网络区域记录已删除。
network-zone-record-updated	网络区域记录已更新。
network-zone-updated	网络区域已更新。
operation-cancelled	操作已取消。
profile-created	已创建新的配置文件。
profile-deleted	配置文件已删除。
profile-renamed	配置文件已重命名。	old_name：之前的名称。
profile-updated	配置文件的配置已更改。
project-created	已创建新的项目。
project-deleted	项目已删除。
project-renamed	项目已重命名。	old_name：之前的名称。
project-updated	项目的配置已更改。
storage-pool-created	已创建新的存储池。	target: 集群成员名称。
storage-pool-deleted	存储池已删除。
storage-pool-updated	存储池的配置已更改。	target: 集群成员名称。
storage-volume-backup-created	已为存储卷创建新的备份。	type: container, virtual-machine, image, 或 custom。
storage-volume-backup-deleted	存储卷的备份已删除。
storage-volume-backup-renamed	存储卷的备份已重命名。	old_name：之前的名称。
storage-volume-backup-retrieved	存储卷的备份已下载。
storage-volume-created	已创建新的存储卷。	type: container, virtual-machine, image, 或 custom。
storage-volume-deleted	存储卷已删除。
storage-volume-renamed	存储卷已重命名。	old_name：之前的名称。
storage-volume-restored	存储卷已从快照中恢复。	snapshot: 正在恢复的快照的名称。
storage-volume-snapshot-created	已创建新的存储卷快照。	type: container, virtual-machine, image, 或 custom。
storage-volume-snapshot-deleted	存储卷的快照已删除。
storage-volume-snapshot-renamed	存储卷的快照已重命名。	old_name：之前的名称。
storage-volume-snapshot-updated	存储卷快照的配置已更改。
storage-volume-updated	存储卷的配置已更改。
warning-acknowledged	警告的状态已设置为“已确认”。
warning-deleted	警告已删除。
warning-reset	警告的状态已设置为“新”。