事件通知概述

您可以在网盘与相册服务PDS管理控制台中,找到域列表,点开对应的域,编辑通知订阅,配置好MNS信息以及需要关心的事件。

使用说明

您在配置好通知订阅之后,需要过5分钟时间才会生效。 配置生效后,您在PDS触发的相应操作,PDS都将通过MNS把事件消息发送到您配置的MNS Topic中。具体流程如下图所示:

1643017753227-05b1ff60-9793-4567-a904-d03cd4ba344b

事件类型

1. 通用消息体

{
    "event_name":"事件名",
    "event_source":"",
    "event_time":"",
    "event_version":"",
    "content":{ // 消息体
    }
}

通用文件信息结构体:EventFileInfo

{
    "drive_id":"",
    "parent_file_id":"",
    "file_id":"",
    "head_revision_id":"",
    "name":"",
    "type":"folder",
    "size":1024,
    "taken_at":"2019-08-20T06:51:27.292Z",
    "local_created_at":"2019-08-20T06:51:27.292Z",
    "file_path":"",
    "file_extension":"",
    "file_category":"",
    "stream_meta":"",
    "content_hash_list":[
      {"hash_name":"","hash_hex_str":"","size":0,"md5":""}
    ]
}

2.文件类事件

触发时机:上传文件(创建文件夹、文件)

事件名:FILE.CREATED

消息体:

{
    "domain_id":"",
    "xxx":"参考上面的 EventFileInfo 字段",
    "client_ip":"",
    "umid_token":""
}

触发时机:更新文件元信息

事件名:FILE.UPDATED

消息体:

{
    "domain_id":"",
    "xxx":"参考上面的 EventFileInfo 字段",
    "updated_labels":["xxx"],
    "attributes":["name","xxxx"] // 被更新字段
}

触发时机:移动文件到回收站,包括后台异步移动的所有子目录文件

事件名:FILE.TRASHED

消息体:

{
    "domain_id":"",
    "drive_id":"",
    "file_list":[
      {
         "xxx":"参考上面的 EventFileInfo 字段"
      }
    ]
}

触发时机:从回收站恢复文件,包括后台异步还原的所有子目录文件

事件名:FILE.RESTORED

消息体:

{
    "domain_id":"",
    "drive_id":"",
    "file_list":[
      {
         "xxx":"参考上面的 EventFileInfo 字段"
      }
    ]
}

触发时机:删除单文件

事件名:FILE.DELETED

消息体:

{
    "domain_id":"",
    "drive_id":"",
    "xxx":"参考上面的 EventFileInfo 字段"
}

触发时机:批量删除文件

事件名:FILE.BATCHDELETED

消息体:

{
    "domain_id":"",
    "drive_id":"",
    "delete_file_list":[
      {    
        "xxx":"参考上面的 EventFileInfo 字段"
      }
    ]
}

触发时机:复制文件,包括后台异步复制的所有文件,每个文件一条消息

事件名:FILE.COPIED

消息体:

{
    "domain_id":"",
    "src_file":{
      "xxx":"参考上面的 EventFileInfo 字段"
    },
    "tgt_file":{
      "xxx":"参考上面的 EventFileInfo 字段"
    }
}

触发时机:移动文件

事件名:FILE.MOVED

消息体:

{
    "domain_id":"",
    "src_file":{
      "xxx":"参考上面的 EventFileInfo 字段"
    },
    "tgt_file":{
      "xxx":"参考上面的 EventFileInfo 字段"
    }
}

触发时机:跨 Drive 移动文件

会发送两条消息,一条删除文件消息和一条复制文件消息

触发时机:文件审核结束。若同时送审了多个内容相同的文件,该文件内容在审核结束时会为每个文件都产生一条消息,此时消息限500条。

事件名:FILE.INVESTIGATED

消息体:

{
    "domain_id":"",
    "drive_id":"",
    "file_id":"",
    "revision_id":"",
    "content_hash_list":[
      {"hash_name":"","hash_hex_str":"","size":0,"md5":""}
    ],
    "investigation_info":{
      "xxx":"参考数据结构InvestigationInfo"
    }
}