Creates a Pub/Sub notification configuration for a given bucket.
Required permissions
The authenticated user must have the storage.buckets.update IAM
permission to use this method.
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:
|
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.