对象存储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
    下一篇
    Object相关接口