对象存储官方事件源
更新时间 2025-06-18 17:55:19
最近更新时间: 2025-06-18 17:55:19
本文介绍对象存储作为事件源发布到事件总线EventBridge的事件类型。
前提条件
对象储存打开事件上报开关,详细步骤如下:
Python调用OpenAPI示例
结合上述示例,执行如下代码,打开指定存储桶的事件上报开关
def main(): params = { "regionID": "bb9fdb42056f11eda1610242ac110002", # 华东1地域ID "bucket": "您的桶名称", "bucketEventBridgeEnabled": True } result=post("https://zos-global.ctapi.ctyun.cn/v4/oss/put-bucket-event-bridge","", params) print(result) if __name__ == "__main__": main()
接口返回以下内容即可
{"message": "SUCCESS", "description": "成功", "statusCode": 800}
事件类型
对象存储支持发布到事件总线EventBridge的事件类型如下所示。
事件类型 | type参数值 |
---|---|
对象解冻 | s3:ObjectRestore:Post |
批量删除对象 | s3:ObjectRemoved:MultiDelete |
拷贝上传 | s3:ObjectCreated:Copy |
不指定版本号删除多版本Bucket中对象 | s3:ObjectRemoved:DeleteMarkerCreated |
删除对象 | s3:ObjectRemoved:Delete |
分段上传对象 | s3:ObjectCreated:CompleteMultipartUpload |
通过Post上传对象 | s3:ObjectCreated:Post |
上传对象 | s3:ObjectCreated:Put |
删除存储桶 | s3:DeleteBucket |
创建存储桶 | s3:CreateBucket |
对象解冻
对象解冻时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653958.796689.9a0364b9e99bb480dd25e1f0284c8555",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectRestore:Post",
"subject": "ctyun.zos:testregionid:s3_test_user_test_other_sub:test_test_pass_7109:test_test_pass_7109_obj",
"time": "2024-08-26 06:32:38.796676Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test_other_sub"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7909",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_7109",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_7109",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.214"
},
"object": {
"key": "test_test_pass_7109_obj",
"size": 7,
"etag": "9a0364b9e99bb480dd25e1f0284c8555",
"versionId": "",
"sequencer": "8621CC6619947C2F",
"metadata": [
{
"key": "x-amz-content-sha256",
"val": "e25caa2414479b291d0fc16aa4cb10655defc97f68d159e982f9790ebd706f80"
},
{
"key": "x-amz-date",
"val": "20240826T063238Z"
}
]
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
批量删除对象
批量删除对象时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653962.665462.00000033989252121724653962665462",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectRemoved:MultiDelete",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_8107",
"time": "2024-08-26 06:32:42.665460Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7962",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_8107",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_8107",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.220"
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
拷贝上传
拷贝上传时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653949.502878.9a0364b9e99bb480dd25e1f0284c8555",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectCreated:Copy",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_6101:test_test_pass_6101_obj_copy",
"time": "2024-08-26 06:32:29.500856Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7841",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_6101",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_6101",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.192"
},
"object": {
"key": "test_test_pass_6101_obj_copy",
"size": 0,
"etag": "9a0364b9e99bb480dd25e1f0284c8555",
"versionId": "",
"sequencer": "7D21CC663261F91D",
"metadata": [
{
"key": "x-amz-content-sha256",
"val": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
{
"key": "x-amz-copy-source",
"val": "test_test_pass_6101_other/test_test_pass_6101_obj"
},
{
"key": "x-amz-date",
"val": "20240826T063229Z"
}
]
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
不指定版本号删除多版本Bucket中对象
不指定版本号删除多版本Bucket中对象时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653944.772059.00000002483101841724653944772059",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectRemoved:DeleteMarkerCreated",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_5101:test_test_pass_5101_obj",
"time": "2024-08-26 06:32:24.772058Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7794",
"x-amz-id-2": "482067-neimeng1-neimeng"
},
"s3": {
"bucket": {
"name": "test_test_pass_5101",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_5101",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.181"
},
"object": {
"key": "test_test_pass_5101_obj",
"size": 0,
"etag": "",
"versionId": "",
"sequencer": "7821CC6690CE042E",
"metadata": [
{
"key": "x-amz-content-sha256",
"val": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
{
"key": "x-amz-date",
"val": "20240826T063224Z"
}
]
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
删除对象
删除对象时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653940.334374.00000027676342321724653940334374",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectRemoved:Delete",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_4101:test_test_pass_4101_obj",
"time": "2024-08-26 06:32:20.334373Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7751",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_4101",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_4101",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.170"
},
"object": {
"key": "test_test_pass_4101_obj",
"size": 0,
"etag": "",
"versionId": "",
"sequencer": "7421CC667A3EEE13",
"metadata": [
{
"key": "x-amz-content-sha256",
"val": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
{
"key": "x-amz-date",
"val": "20240826T063220Z"
}
]
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
分段上传对象
分段上传对象时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653933.479414.b18b80ee6c1670a8e6356ec8dd991a0d-4",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectCreated:CompleteMultipartUpload",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_3203:test_test_pass_3203_obj",
"time": "2024-08-26 06:32:13.479413Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7705",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_3203",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_3203",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.160"
},
"object": {
"key": "test_test_pass_3203_obj",
"size": 0,
"etag": "b18b80ee6c1670a8e6356ec8dd991a0d-4",
"versionId": "",
"sequencer": "6D21CC669159931C",
"metadata": [
{
"key": "x-amz-content-sha256",
"val": "d893c8c13afb7932edb493069990d4de21a55ca2b254a7491ad6bada3bccbb3f"
},
{
"key": "x-amz-date",
"val": "20240826T063213Z"
}
]
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
通过Post上传对象
通过Post上传对象时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653923.776499.b6d81b360a5672d80c27430f39153e2c",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectCreated:Post",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_2201:test_test_pass_2201_obj",
"time": "2024-08-26 06:32:03.776499Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7658",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_2201",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_2201",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.148"
},
"object": {
"key": "test_test_pass_2201_obj",
"size": 1048576,
"etag": "b6d81b360a5672d80c27430f39153e2c",
"versionId": "",
"sequencer": "6321CC661A84482E",
"metadata": []
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
上传对象
上传对象时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653920.454169.9a0364b9e99bb480dd25e1f0284c8555",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:ObjectCreated:Put",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_2101:test_test_pass_2101_obj",
"time": "2024-08-26 06:32:00.452031Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7610",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_2101",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_2101",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.136"
},
"object": {
"key": "test_test_pass_2101_obj",
"size": 7,
"etag": "9a0364b9e99xxxxxx25e1f0284c8555",
"versionId": "",
"sequencer": "6021CC66CB1F121B",
"metadata": [
{
"key": "x-amz-content-sha256",
"val": "ed7002b439e9ac845f22357dxxxxx30fbdb6016d3ec9432297b9ec9f73"
},
{
"key": "x-amz-date",
"val": "20240826T063200Z"
}
]
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
删除存储桶
删除存储桶时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653909.363413.00000013684934331724653909363413",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:DeleteBucket",
"subject": "ctyun.zos:testregionid:s3_test_user_test:test_test_pass_1102",
"time": "2024-08-26 06:31:49.363412Z",
"data": {
"userIdentity": {
"principalId": "s3_test_user_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7582",
"x-amz-id-2": "482067"
},
"s3": {
"bucket": {
"name": "test_test_pass_1102",
"ownerIdentity": {
"principalId": "s3_test_user_test"
},
"arn": "arn:aws:s3:::test_test_pass_1102",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.121"
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_user_test_ctyun_id",
"ctyunuserid": "s3_test_user_test_ctyun_uid",
"ctyunresourceid": "",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}
创建存储桶
创建存储桶时,事件总线EventBridge接收到的示例事件如下所示:
{
"id": "1724653908.281238.00000032640735281724653908281238",
"source": "ctyun.zos",
"specversion": "1.0",
"type": "s3:CreateBucket",
"subject": "ctyun.zos:testregionid:s3_test",
"time": "2024-08-26 06:31:48.281237Z",
"data": {
"userIdentity": {
"principalId": "s3_test"
},
"responseElements": {
"x-amz-request-id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726887.7580",
"x-amz-id-2": "482067-xxx"
},
"s3": {
"bucket": {
"name": "wty_test_pass_1101",
"ownerIdentity": {
"principalId": "s3_test"
},
"arn": "arn:aws:s3:test",
"id": "80f2843f-e96b-45f1-aff1-a6a4c5d8b7bb.4726926.120"
}
}
},
"datacontenttype": "application/json;charset=utf-8",
"ctyunaccountid": "s3_test_ctyun_id",
"ctyunuserid": "s3_test_ctyun_uid",
"ctyuneventbusname": "default",
"ctyunregion": "testregionid"
}