事件通知

最近更新时间: 2023-12-25 11:31:50

事件通知功能，能够对管理员所关心的存储资源操作及时进行消息通知。例如：

有新数据从图片内容分享平台、音视频平台上传到七牛云对象存储 Kodo
资源发生了更新
重要文件被删除
数据同步已经完成

具体说明

您创建事件通知规则后，若请求者对您的对象存储 Kodo 资源进行操作并触发了事件通知规则，则请求者对 Kodo 进行的相关操作将会被发送到您配置的 HTTP(s) 服务端地址上。您可以针对事件通知返回的消息进行收集分析，如重点信息特别关注、数据统计分析等。
事件通知当前针对操作成功的事件进行通知。
事件通知是异步进行的，不影响正常的操作。事件通知的配置包括规则和消息通知两部分。
- 规则：用来描述什么情况下需要进行消息通知。
- 消息通知：支持以回调方式将消息推送到指定 URL。

事件类型

事件类型	事件说明
put	创建/覆盖文件：简单上传
copy	创建/覆盖文件：拷贝文件
append	创建/覆盖文件：追加上传
move	移动文件
delete	删除文件：1 个或多个
mkfile	创建/覆盖文件：分片上传完成
disable	修改文件状态：禁用
enable	修改文件状态：启用
restore:completed	文件解冻：完成

回调消息格式

{
   “Message”:“{
       “event”:“put”,
       “time”:1547551207786351434,
       “reqid”:“niNkZJy_3M9903AEA”,
       “source_ip”:“33.236.132.29”, 
       “user_id”:“uid:111111”,
       “access_key”:“akjFT8jsaYB8kj-90HJJkds”,
       “bucket”:“bucket_name”,
       “key”:“event1_tets.txt”,
       “fsize”:6,
       “hash”:“FhWqsP2Lk36zuwGEFpPzXct12i-v”,
       “ftype”:0,
       “mimetype”:“application/octet-stream”,
       “restore_expiration”:“2019-01-20T19:20:07+08:00”,
       “dest_bucket”:“dest_bucket_name”,
       “dest_key”:“dest_key_name”
   }”,
   “Subject”: “Qiniu KODO Notification”,
   “Timestamp”: “2019-01-15T19:20:07+08:00” //事件通知发送时间
}

Message 回调消息参数	说明
event	事件类型
time	事件发生时间，纳秒级时间戳
reqid	请求的 Request ID
source_ip	请求的源 IP
user_id	请求者 uid - 普通账号 `qrn:iam::<root-uid>:root`，如：qrn:iam::1111111:root - IAM 子账号 `qrn:iam::<root-uid>:user/<user-name>`，如：qrn:iam::1111111:user/iam-test - 系统账号 `qrn:<product>::<service>:admin` product 为 Kodo service 支持为 replication 跨区域同步、lifecycle 生命周期、access_log 空间日志、restore 对象解冻
access_key	请求者 ak，需要配合 user_id 识别 - 普通账号 ak - IAM 子账号 ak，如：IAM-qnd-njkG89ndsxxxxxxxxx - 系统账号 admin，同系统账号的 user_id 信息一致
bucket	Bucket 名称
key	Object 名称
fsize	Object 大小
hash	Object Etag 值
ftype	Object 的存储类型 - 0 标准存储、1 低频存储、2 归档存储、3 深度归档存储、4 归档直读存储
mimetype	Object 的 mimeType
restore_expiration	Object 的解冻到期时间，仅 restore:completed 事件返回
dest_bucket	目标 Bucket 名称，仅 copy/move 事件返回
dest_key	目标 Object 名称，仅 copy/move 事件返回

操作方式

Kodo 支持通过控制台方式设置事件通知。

支持的操作方式	参考文档
控制台	设置事件通知

以上内容是否对您有帮助？

对象存储

事件通知

具体说明

事件类型

回调消息格式

操作方式