Notifications: insert

Creates a Pub/Sub notification configuration for a given bucket. Try it now.


HTTP request


In addition to standard query parameters, the following query parameters apply to this method:


Parameter name Value Description
Path parameters
bucket string The parent bucket of the notification.

Request body

In the request body, supply a notification resource with the following properties:

Property name Value Description Notes
Required Properties
topic string The Pub/Sub topic to which this subscription publishes. Formatted as: '//{project-identifier}/topics/{my-topic}' writable
payload_format string The desired content of the Payload.

Acceptable values are:
  • "JSON_API_V1"
  • "NONE"
Optional Properties
custom_attributes object An optional list of additional attributes to attach to each Pub/Sub message published for this notification subscription. writable
event_types[] list If present, only send notifications about listed event types. If empty, send notifications for all event types. writable
object_name_prefix string If present, only apply this notification configuration to object names that begin with this prefix. writable


If successful, this method returns a notification resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.