PostEvent
更新时间:2024-10-29
接口描述
将事件消息推送到配置的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 |
eventFrom | String | 触发事件的请求来源,表示请求来源于用户、BOS生命周期、BOS数据同步、BOS批处理。 有效值: Client/Lifycycle/Replication/Batch。 默认是"Client",如果没有设置此字段则表示取值是默认值。 |
eventId | String | 事件唯一标识 |
eventOrigin | String | 事件触发源,当前支持增量(bos:realtime ) |
eventType | String | 事件类型 |
eventTime | String | 事件发生时间(GMT格式) |
configurationId | String | 事件对应的事件通知规则id。 |
content | Object | 事件具体信息 |
+domain | String | 所属的domain |
+bucket | String | 所属的bucket |
+object | String | object名字 |
+eTag | String | object的eTag,如果object可能被覆盖,则需要用eTag判断是哪个版本的object触发的事件 |
+contentType | String | object的Content-Type |
+copySourceBucket | string | 如果是CopyObject 事件或BosLifecycle:Copy 事件,表示源object所在bucket名称。 |
+copySourceObject | string | 如果是CopyObject 事件或者BosLifecycle:Copy 事件,表示源Object名称。 |
+copySourceStorageClass | string | 如果是CopyObject 事件或者BosLifecycle:Copy 事件,表示源object的存储类型。 |
+storageClass | string | 触发事件的object的存储类型。 |
+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", "eventFrom": "Client", "eventId": "2a513199-bbb9-4ac7-b12a-60213c26810d", "eventOrigin": "bos:realtime", "eventTime": "2018-09-05T02:28:49Z", "eventType": "CopyObject", "configurationId": "notify-id-1", "content": { "userId": "c7ac82ae14ef42d1a4ffa3b2ececa17f", "domain": "bj.bcebos.com", "bucket": "bucket-test", "object": "images/test.jpg", "eTag": "977b9623a15e520c663ac5ff6647e881", "contentType": "application/octet-stream", "copySourceBucket": "src-bucket", "copySourceObject": "src-object", "copySourceStorageClass": "STANDARD", "storageClass": "COLD", "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