適用場景

• 當您授權其他用戶對您的資源（Bucket）進行某些操作的權限，且希望關注這些操作，可以通過創建規則，在這些操作發生時主動通知您。

• 通過事件通知的方式進行數據分析、查看一段時間內某個操作發生的次數，分析您的業務最近的發展趨勢。您還可以將這些事件通知的消息導入其他服務，例如EMR，進一步進行自定義分析。

• 通過事件通知監控您的資源上發生的某些操作的QPS等指標。

事件類型

消息格式

對象存儲OSS的事件通知消息內容是經過Base64編碼的，解碼后是JSON格式，示例代碼如下所示。

{
    "events":[
        {
            "eventName":"ObjectDownloaded:GetObject",
            "eventSource":"acs:oss",
            "eventTime":"2016-07-01T11:17:30.000Z",
            "eventVersion":"1.0",
            "oss":{
                "bucket":{
                    "arn":"acs:oss:cn-shenzhen:123456789098****:event-notification-test-shenzhen",
                    "name":"event-notification-test-shenzhen",
                    "ownerIdentity":"123456789098****"
                },
                "object":{
                    "deltaSize":0,
                    "eTag":"0CC175B9C0F1B6A831C399E26977****",
                    "key":"test",
                    "readFrom":0,
                    "readTo":1,
                    "size":1
                },
                "ossSchemaVersion":"1.0",
                "ruleId":"GetObjectRule"
            },
            "region":"cn-shenzhen",
            "requestParameters":{
                "sourceIPAddress":"140.205.XX.XX"
            },
            "responseElements":{
                "requestId":"5776514AF09A9E654242****"
            },
            "userIdentity":{
                "principalId":"123456789098****"
            },
            "xVars":{
                "x:callback-var1":"value1",
                "x:vallback-var2":"value2"
            }
        }
    ]
}

參數解釋如下所示。

注意事項

• 事件通知規則創建完成后，約10分鐘生效。

• 系統會自動為新建的規則創建主題，主題可能產生費用，詳情請參見計費說明。

• 事件通知規則支持創建和刪除，暫時不支持修改。

步驟一：創建隊列

1. 登錄輕量消息隊列（原 MNS）控制臺。

2. 在左側導航欄，選擇隊列模型 > 隊列列表。

3. 在頂部菜單欄，選擇地域。

4. 在隊列列表頁面，單擊創建隊列。

5. 在創建隊列面板配置以下參數，然后單擊確定。

   • 名稱：隊列名稱。

   • 消息最大長度：發送到隊列的消息體的最大長度。

   • 長輪詢時間：當隊列中沒有消息時，該隊列的ReceiveMessage請求的最大等待時長。

   • 消息可見性超時時間：消息從隊列中取出后從Active狀態變成Inactive狀態后的持續時間。

   • 消息保存時長：消息在隊列中的最長存活時間。從發送到隊列開始經過此參數指定的時間后，不論消息是否被取出都將被刪除。

   • 消息定時時間：發送到隊列的所有消息將延后此參數指定的時間后被消費。

   • 啟用日志功能：是否開啟日志管理功能。

   隊列列表頁面目標隊列已創建。

步驟二：創建Bucket

1. 登錄OSS管理控制臺。

2. 在左側導航欄，單擊Bucket列表。

3. 在Bucket列表頁面，單擊創建Bucket。

4. 在創建 Bucket面板，配置Bucket參數，然后單擊確定。

   • Bucket 名稱：輸入event-notification-test。

   • 地域：跟隊列所在的地域保持一致。

   • 阻止公共訪問：不開通

   • 讀寫權限：選擇公共讀寫。

     說明

     其他配置項請保持默認。

步驟三：創建自定義規則

創建一個新規則后，輕量消息隊列（原 MNS）會自動創建一個主題，并且以指定的Endpoint創建訂閱。您可以在輕量消息隊列（原 MNS）控制臺查看和管理這些主題與訂閱（例如創建新的訂閱）。

1. 登錄輕量消息隊列（原 MNS）控制臺。

2. 在左側導航欄，單擊事件通知。

3. 在頂部菜單欄，選擇地域。

4. 在事件通知頁面，單擊對象存儲OSS頁簽， 然后單擊創建規則。

5. 在創建規則-對象存儲OSS面板，進行以下配置，然后單擊確定。

   • 名稱：輸入規則名稱。

   • 事件類型：選擇事件類型。

   • 匹配規則：設置匹配規則。

     說明

     匹配規則可以是全名、前綴、后綴以及前后綴，不同規則不能有交集。OSS資源包括Bucket和Object，通過“/”連接。例如：資源movie/hello.avi由Bucket（movie）和Object（hello.avi）組成。

     • 全名：movie/hello.avi。

     • 前綴：

       • movie/hello：movie中以hello為前綴的Object。

       • movie/：Bucket名稱為movie的所有的Object。

       • mov：Bucket名稱前綴為mov的所有Object。

     • 后綴：.avi：所有Bucket中以.avi為后綴的Object。

     • 前后綴：前綴movie/，后綴.avi：movie中所有以.avi為后綴的Object。

   • 接收終端：選擇隊列，輸入步驟一中創建的隊列名稱。

步驟四：上傳Object

1. 登錄OSS管理控制臺。

2. 在左側導航欄，單擊Bucket列表。

3. 在Bucket列表頁面，單擊Bucket名稱列下的目標Bucket。

4. 選擇文件管理 > 文件列表，然后單擊上傳文件。

5. 在上傳文件面板，配置文件上傳目錄和文件ACL，單擊上傳文件。更多配置參數信息，請參見使用OSS控制臺上傳文件。

   狀態列顯示：上傳成功。

步驟五：接收消息

1. 登錄輕量消息隊列（原 MNS）控制臺。

2. 在左側導航欄，選擇隊列模型 > 隊列列表。

3. 在頂部菜單欄，選擇地域。

4. 在隊列列表頁面，找到目標隊列，在其右側操作列選擇更多 > 收發消息。

5. 在隊列收發消息快速體驗頁面的接收消息區域，單擊接收消息。

   接收消息區域顯示隊列的消息列表。

6. 在消息列表中，找到目標消息，在其右側操作列單擊詳情，在消息詳情對話框中查看消息內容。