Feature description

This API retrieves the event notification rules set for a specified bucket.

Notes

To call this API, you must be the bucket owner or have the GetBucketNotification permission for the current bucket.

It is recommended to use the GetBucketNotificationV2 API, which is compatible with event notification rules created by the PutBucketNotification API.

Request syntax

Request parameters and headers

Name	Location	type	Required	Sample value	Note
notification	Query	String	Yes	-	Special identifier representing the PutBucketNotification request.

Request elements

This request has no message elements.

Response headers

The common response headers returned by this request. See Common Parameters.

Response body elements

Name	Type	Sample value	Note
CloudFunctionConfigurations	Array	-	Information on the event notification rule.
Event	Array	[ "tos:ObjectCreated:Put"]	Types of events that require notification. For a list of types supported by TOS, see Supported event types. Parent node: CloudFunctionConfigurations
Filter	Container	-	Configured filter rules. Parent node: CloudFunctionConfigurations
TOSKey	Container	-	Currently supports returning FilterRule, which is the object's filter information. Parent node: Filter
FilterRules	Array	[ { "Name": "prefix", "Value": "test_" }, { "Name": "suffix", "Value": ".jpg" } ]	filter rules that the object needs to match. Supports prefix and suffix, which filter event objects according to prefix and suffix rules respectively. When both prefix and suffix rules are set, the event must meet both conditions to trigger notification. if neither a prefix nor a suffix is set, all objects in the bucket will be matched. parent node: TOSKey
Name	String	suffix	Conditions to match. The options are as follows: prefix: prefix. suffix: suffix. Parent node: FilterRules
Value	String	.jpg	prefix and suffix information to match. parent node: FilterRules
RuleId	String	TestNotification	Name of the event notification rule. Parent node: CloudFunctionConfigurations
CloudFunction	String	l2u0****	Function ID for event delivery. Parent node: CloudFunctionConfigurations

Sample request

Sample response