Event Notification and Data Processing

Updated at：2025-11-03

Overview

The BOS event notification system is a smart trigger platform based on the BOS data processing framework V2.0. Developers can define data behaviors of interest within buckets using built-in platform functions. BOS monitors bucket operations like Put Object and Append Object and notifies downstream service systems of trigger events.

In addition, BOS integrates Baidu AI Cloud's powerful AI features, supporting direct triggering of advanced data processing capabilities based on monitored user behaviors and ensuring that processed results are delivered directly to businesses' downstream systems. This approach simplifies development logic, speeds up processes, and empowers users with superior data AI capabilities.

Application scenarios

The BOS event notification platform offers developers an automated system for monitoring and notifying about data behaviors, addressing multiple application scenarios such as:

When new data is uploaded to a bucket, the application is immediately notified so it can retrieve and utilize the data right away.
When images are uploaded to a bucket, they are processed immediately. The resulting new images are used for frontend display, and the original images are promptly deleted to free up storage space.
When videos are uploaded to a bucket, content moderation (for pornography and illegal content) is carried out immediately. Any non-compliant content is promptly removed.
When operations like PutObject or DeleteObject occur in a bucket and need to trigger subsequent custom processing workflows, this can be achieved via the BOS Trigger for CFC Function Computing.

In these scenarios, BOS users only need to configure trigger conditions on the event notification console, such as event name, encrypted authentication settings, monitored resources, covered resources, and triggered applications. Once configured, any changes to monitored resources in the specified bucket or under the specified prefix will automatically trigger the relevant application.

Prerequisites

A Baidu AI Cloud account has been registered. For specific operations, please refer to [Register a Baidu AI Cloud Account](UserGuide/Register an account.md#Register a Baidu Account).
The resources covered by an event notification rule refer to a single bucket or all files under a specific prefix in a bucket. Therefore, you first need to select the bucket for which to create the event notification rule. For details, see [Create Bucket](BOS/Console Operation Guide/Managing Bucket/Create bucket.md).

Supported regions

Currently, only Beijing, Suzhou, and Guangzhou are supported. For support in more regions, please Submit a Ticket.

Create rules

Note: Archived objects that have not been restored will not trigger event notifications. However, restored archived objects can trigger notifications as usual.

Sign in to the BOS Management Console and navigate to the Global Overview page.
In the left navigation bar of the BOS console, select the target Bucket, then click to open the bucket’s file list page.
Click the Event Notification tab in the top navigation bar of the page to enter the Event Notification page.
Click Create Rule to enter the creation page, and configure the following information:

Parameters	Description
Status	Choose whether to enable event notifications for the rule.
Name	Supports uppercase and lowercase letters, numbers, Chinese characters, and special characters (-_ /. ). Must start with a letter and be between 1-65 characters in length.
Rule ID	Supports uppercase and lowercase letters, numbers, and special characters (-_ /. ). Must start with a letter and be between 1-65 characters in length.
Product ID	Supports uppercase and lowercase letters, numbers, and special characters (-_ /. ). Must start with a letter and be between 1-65 characters in length.
Encrypted authentication	Choose whether to encrypt the event notification rule. If encryption is enabled: Enter a custom 32-character password (supports uppercase and lowercase letters and numbers). Or simply enter the SK directly. If you only create an empty event, you must set a secret key. Make sure to save the password promptly to avoid losing it; BOS does not store passwords.
Event monitoring configuration	Choose whether to enable event monitoring. Configure if enabled: Monitored Events: API actions that occur in the bucket. Currently, BOS supports the following monitored events; you can select one or multiple events as needed. AppendObject: Append upload action occurs; CompleteMultipartUpload: Three-step upload is completed; CopyObject: Data copy action occurs; PutObject: Simple upload action occurs; PostObject: Form upload action occurs; FetchObject: Action of fetching resources from a specified URL and storing them occurs; DeleteObject: Action of deleting a single object occurs; "BosLifecycle:Copy": Lifecycle-triggered replication events, including CopyObject requests and the third step of CompleteMultipartUpload requests for multipart replication. Covered Resources: The data scope monitored by the rule. Covered resources support bucket-level resources and can also be configured by specifying resource prefixes/suffixes. A single rule can monitor up to 5 different covered resources. When specifying a prefix/suffix, a single prefix can contain a maximum of 1 “” symbol. Triggered Applications*: Downlink services that need to be notified by the rule. Users can flexibly set the application that receives trigger notifications based on their own business architecture. Triggered applications are categorized into three types: Baidu official applications, Cloud Function Compute (CFC), and custom applications. For details about triggered applications, see Triggered Application Categories.

Click Confirm to save the rule configuration. Successfully created rules can be viewed in the rule list on the Event Notification page. You can also perform management operations such as modifying or deleting existing rules.

Triggered application categories

Triggered applications fall into three categories: Baidu official applications, Cloud Function Compute (CFC), and custom applications. Baidu official applications: By leveraging Baidu AI Cloud’s robust data AI processing, BOS integrates various high-frequency, simple-to-use AI applications. Users just need to set a URL in the console to receive processed application results, enabling them to enhance their business efficiently with minimal development effort.

Currently, Baidu official applications include general text recognition, general object recognition, and multimedia cloud transcoding.

Application category	Application name	Application description
Baidu official applications	General text recognition	Baidu’s general text recognition offers top performance across multiple scenarios, ranking high in various ICDAR metrics. It's one of the most widely used and established AI capabilities on Baidu AI Cloud. When the general text recognition application is triggered, BOS automatically sends data uploaded to the bucket to the Baidu general text recognition service. After processing, BOS delivers the results to the user’s specified receiving URL in a structured JSON file.
	General object recognition	Baidu’s general object recognition enables users to analyze, extract, and tag image content, playing a key role in advanced applications like image clustering or optical character recognition. When the general object recognition application is triggered, BOS automatically sends data uploaded to the bucket to the Baidu general object recognition service. After processing, BOS delivers the results to the user’s specified receiving URL in a structured JSON file.
	Multimedia Cloud Transcoding	Multimedia cloud transcoding provides efficient, intelligent, and stable processing for massive media assets, supporting standard transcoding, speed-adjusted transcoding, intelligent HD transcoding, video editing, video encryption, and intelligent frame extraction. It ensures a seamless HD playback experience across various terminals. When the multimedia cloud transcoding application is triggered, BOS automatically sends audio/video data uploaded to the bucket to the Baidu multimedia cloud transcoding service. After processing, BOS delivers the results to the user’s specified receiving URL.
	Abnormal image detection	The abnormal image detection application supports configuring the detection rate and target output path. It delivers detection results of image/detect in JSON format to the target bucket and path The generated file format is ${prefix}/${detectDate}/${srcBucket}_${detectTime}, where: - ${prefix} = configured target path; ${detectDate} = detection date (e.g., “20241001” for October 1, 2024); ${srcBucket} = name of the bucket configured for abnormal image detection; ${detectTime} = detection time (e.g., “2024-10-01_12” for the 12:00-13:00 window on October 1, 2024)
Cloud Function Computing (CFC)	Cloud Function Compute (CFC)	Cloud Function Compute (CFC) is an event-driven, fully managed cloud computation service officially provided by Baidu AI Cloud. After defining the formula for the triggered function calculation, BOS automatically sends the data uploaded to the bucket to the Baidu function computing service. Once processing is complete, BOS delivers the results to the user-specified receiving URL.
Custom applications	Custom applications	Custom applications refer to users' proprietary downstream apps or other application systems. Users only need to specify the URL where their business receives trigger notifications, and BOS will push the events monitored in the bucket to that URL.

[PutNotification API](BOS/API Reference/Bucket-Related Interface/Event notification/PutNotification.md): Use the PutNotification API to create event notification rules.
[GetNotification API](BOS/API Reference/Bucket-Related Interface/Event notification/GetNotification.md): Use the GetNotification API to get created event notifications,.

Intelligent Business Analysis

View and export usage data

BOS

BOS