Event notification

Updated at：2025-11-03

put_notification

This API sets notification rules for a specified bucket.

Note:

Only the bucket owner or users with FULL_CONTROL permission can access this bucket's configuration.

A 403 status will be returned if the requester is not the bucket owner, or a 404 status if the specified file does not exist.

For a detailed explanation of relevant parameters, please refer to [PutNotification API](BOS/API Reference/Bucket-Related Interface/Event notification/PutNotification.md).

                Python
                
            

                notifications = list()
notifications.append(
    {
        "resources": [
            "/"
        ],
        "encryption": {
            "key": "06a62b70f47dc4a0a7da349609f1a1ac"
        },
        "status": "enabled",
        "name": "name3",
        "id": "r3",
        "appId": "p3",
        "events": [
            "AppendObject",
            "CompleteMultipartUpload",
            "CopyObject",
            "PutObject",
            "PostObject",
            "FetchObject",
            "DeleteObject"
        ],
        "apps": [
            {
                "eventUrl": "http://www.liujiang.com",
                "id": "ImageCensor",
                "xVars": "{\"saveUrl\": \"http://xxx.com/ocr\"}"
            }
        ]
    })
response = bos_client.put_notification(bucket_name, notifications)
            

get_notification

This API retrieves notification rules for a specified bucket.

                Python
                
                response = bos_client.get_notification(bucket_name)

delete_notification

This API is designed to delete notification rules for a specified bucket.

Note:
This API is used to delete all rules under the current bucket at one time

                Python
                
                response = bos_client.delete_notification(bucket_name)

Bucket Lifecycle Management

Set bucket storage class