事件通知
更新時間 2024-03-29 17:54:28
最近更新時間: 2024-03-29 17:54:28
分享文章
本章節為媒體存儲事件通知概述。
使用場景
媒體存儲支持事件通知能力,當對象存儲資源發生變動(如新對象上傳、刪除對象)時,用戶可通過事件通知配置及時收到通知消息。
適用區域
本功能目前僅部分資源池支持,具體可參考:資源池與區域節點。
如需使用,可聯系客戶經理或提交工單申請。
使用說明
- 事件類型:支持多選,匹配一個事件類型觸發一條通知。
- 資源描述 - 前綴、后綴:前后綴各支持配置一個。
- 資源描述 - 元數據:支持配置10個元數據,對象必須包含所配置的元數據才視為匹配。
- 當資源描述包含多個條件時,對象必須匹配所有條件才視為匹配。
- 目前事件通知回調暫不支持鑒權,用戶需提供無需鑒權的回調地址。
- 當事件回調失敗時,服務會重試回調,直至回調成功。
事件類型
事件通知目前支持以下事件類型:
| 事件類型 | 說明 |
|---|---|
| ObjectCreated:* | 所有上傳對象的操作 |
| ObjectCreated:Put | 通過PutOject接口上傳對象的操作 |
| ObjectCreated:Post | 通過PostObject接口上傳對象的操作 |
| ObjectCreated:Copy | 通過Copy接口上傳對象的操作 |
| ObjectCreated:CompleteMultipartUpload | 通過分片上傳接口上傳對象的操作 |
| ObjectRemoved:* | 所有刪除對象的操作 |
| ObjectRemoved:Delete | 通過DeleteObject接口刪除對象的操作 |
| ObjectRemoved:DeleteMarkerCreated | 開啟多版本的存儲桶,在不指定versionId刪除對象時會插入一個DeleteMarker的操作 |
事件通知消息結構
事件通知消息結構如下:
{
"Records": [
{
"eventVersion": "", // 版本號
"eventSource": "", // 消息源,固定為"ctyun:s3"
"awsRegion": "", // 事件所在的region
"eventTime": "", // 事件時間,格式為ISO-8601,示例:2023-06-13 02:20:19.032936Z
"eventName": "", // 觸發事件通知的事件名
"userIdentity": {
"principalId": "" // 觸發事件的用戶ID
},
"requestParameters": {
"sourceIPAddress": "" // 請求的源IP
},
"responseElements": {
"x-amz-request-id": "", // 請求對應的requestid
"x-amz-id-2": "" // 幫助定位問題的特殊符號
},
"s3": {
"s3SchemaVersion": "1.0",
"configurationId": "", // 事件匹配的事件通知規則的名稱
"bucket": {
"name": "examplebkt", // 桶名
"ownerIdentity": {
"principalId": "" // 桶擁有者的帳號ID
},
"arn": "arn:aws:s3:::examplebkt", // 桶的ARN
"id": "" // 桶id
},
"object": {
"key": "object", // 對象名
"size": 779, // 對象大小
"etag": "", // 對象ETag
"versionId": "", // 對象版本Id
"sequencer": "", // 確定某個特定對象事件順序的標識
"metadata": [
{
"key": "x-amz-meta-a", // 用戶自定義元數據
"val": "2"
}
],
}
},
"eventId": "" // 事件ID
}
]
}
?使用方式
| 操作途徑 | 使用方式 |
|---|---|
| 控制臺 | 可參考:事件通知。 |