对象存储

  • 对象存储 > 使用指南 > 开发指南 > 管理存储空间 > 事件通知

    事件通知

    最近更新时间: 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 支持通过控制台方式设置事件通知。

    支持的操作方式 参考文档
    控制台 设置事件通知
    以上内容是否对您有帮助?
  • Qvm free helper
    Close