Creates a Pub/Sub notification configuration for a given bucket.
Request
HTTP request
POST https://storage.googleapis.com/storage/v1/b/ bucket /notificationConfigs
In addition to standard query parameters , the following query parameters apply to this method.
To see an example of how to include query parameters in a request, see the JSON API Overview page.
Parameters
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:
"//pubsub.googleapis.com/projects/ PROJECT-IDENTIFIER
/topics/ TOPIC-NAME
"
writable
payload_format
string
The desired content of the Payload.
Acceptable values are:
Acceptable values are:
-
"JSON_API_V1" -
"NONE"
writable
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
Response
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.
