Baidu AI Cloud
中国站

百度智能云
All Product Document

Object Storage

  • Object Storage
  • >
  • API Reference
  • >
  • Bucket Related Interfaces
  • >
  • Event Notification
  • >
  • PostEvent

PostEvent

Last Updated：2021-12-08

Interface Description

It is used to push the event message to the configured URL.

If the encryption field is configured in the rule, the Authorization signature is contained in the request to ensure that the message is not forged or tampered with.

Notes:

  • It is considered that the message is pushed successfully only when it returns Status Code: 200 OK. Otherwise, it retries.
  • For the overload protection, it returns Status Code: 429 Too Many Requests and retries after a period of time.

Request

  • Request syntax

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

  • Request header field

    None

  • Query parameters

Field Type Description
version String Event version. The current version is 1.0.
eventId String Unique event ID
eventOrigin String Event triggering origin, which supports the increment (bos:realtime) currently.
eventType String Event type
eventTime String Event occurrence time (GMT format)
content Object Specific event information
+domain String Domain
+bucket String Affiliated bucket
+object String Object name
+eTag String eTag of object. If an object may be overwritten, eTag is required to judge which version of the object triggers the event.
+contentType String Object Content-Type
+filesize Number File size
+lastModified String File update time
+credentials Object Temporary authorization of relevant resources. For the specific usage, see Temporary Access Authorization.
++accessKeyId String Access Key ID for the temporary authorization
++secretAccessKey String Secret Access Key for the temporary authorization
++sessionToken String Session Token for the temporary authorization
++expiration String Effective time of the temporary authorization
++xVars String xVars original text in the user setting notification

Response

  • Response header field

    None

  • Response element

    None

Example

  • Request example

    ```
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\"}"
            }
        }
    ]
}
```

  • Response example

    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
Previous
GetNotification
Next
PostResult