PostEvent
所有文档

          对象存储 BOS

          PostEvent

          接口描述

          将事件消息推送到配置的url上。

          如果规则中配置了encryption字段,那么请求中会包含Authorization的签名,保证消息不会被伪造或篡改。

          注意:

          • Status Code: 200 OK才会认为消息推送成功,否则将会重试;
          • 对于过载保护的情况,支持Status Code: 429 Too Many Requests返回值,会间隔一段时间再重试;

          请求

          • 请求语法

            http
            POST /?event HTTP/1.1
            Host: <User_Host>
            Date: <Date>
            Content-Type: application/json; charset=utf-8
            Content-Length: <Content_Length>
            Authorization: <AuthorizationString>
          • 请求头域

          • 请求参数

          字段 类型 说明
          version String 事件版本,当前为1.0
          eventId String 事件唯一标识
          eventOrigin String 事件触发源,当前支持增量(bos:realtime)
          eventType String 事件类型
          eventTime String 事件发生时间(GMT格式)
          content Object 事件具体信息
          +domain String 所属的domain
          +bucket String 所属的bucket
          +object String object名字
          +eTag String object的eTag,如果object可能被覆盖,则需要用eTag判断是哪个版本的object触发的事件
          +contentType String object的Content-Type
          +filesize Number 文件大小
          +lastModified String 文件更新时间
          +credentials Object 相关资源的临时授权,具体使用参考临时授权访问
          ++accessKeyId String 临时授权的Access Key ID
          ++secretAccessKey String 临时授权的Secret Access Key
          ++sessionToken String 临时授权的Session Token
          ++expiration String 临时授权的的有效时间
          ++xVars String 用户设置通知中的xVars原文

          响应

          • 响应头域

          • 响应元素

          示例

          • 请求示例

            ```
            http
            POST /?event HTTP/1.1
            Host: BucketName.bj.bcebos.com
            Date: Wed, 12 Sep 2018 06:34:40 GMT
            Content-Type: application/json; charset=utf-8
            Content-Length: 0
            
            {
                "events": [
                    {
                        "version": "1.0",
                        "eventId": "2a513199-bbb9-4ac7-b12a-60213c26810d",
                        "eventOrigin": "bos:realtime",
                        "eventTime": "2018-09-05T02:28:49Z",
                        "eventType": "PutObject",
                        "content": {
                            "userId": "c7ac82ae14ef42d1a4ffa3b2ececa17f",
                            "domain": "bj.bcebos.com",
                            "bucket": "bucket-test",
                            "object": "images/test.jpg",
                            "eTag": "977b9623a15e520c663ac5ff6647e881",
                            "contentType": "application/octet-stream",
                            "filesize": 24414,
                            "lastModified": "2018-09-05T02:28:49Z",
                            "credentials": {
                                "accessKeyId": "f3ade7c6b1a911e8bb6821a724cc157d",
                                "secretAccessKey": "07381a56d35e4b1193a418362221de81",
                                "sessionToken": "ZGZiM2M3MmU4Mjk4NGQ2MGEzYTNhYTAyMDE3NTZmZmV8AAAAAIcCAADaE18IR6jSaVWlMHxZG5wzb/7AQas3Y6V",
                                "expiration": "2018-02-22T11:22:33Z"
                            },
                            "xVars": "{\"saveUrl\": \"http://xxx.com/ocr\"}"
                        }
                    }
                ]
            }
            ```
          • 响应示例

            HTTP/1.1 200 OK
            x-bce-request-id: 4db2b34d-654d-4d8a-b49b-xxxxxx786409
            Date: Wed, 12 Sep 2018 06:34:40 GMT
            Content-Length: 0
            Connection: close
            Server: BceBos
          上一篇
          PostResult
          下一篇
          请求者付费