To try out the methods for this resource, see Methods.

Resource representations

A subscription to receive Pub/Sub notifications.

  "id": string,
  "topic": string,
  "event_types": [
  "custom_attributes": {
    (key): string
  "payload_format": string,
  "object_name_prefix": string,
  "etag": string,
  "selfLink": string,
  "kind": "storage#notification"
Property name Value Description Notes
custom_attributes object An optional list of additional attributes to attach to each Pub/Sub message published for this notification subscription. writable
custom_attributes.(key) string
etag string HTTP 1.1 Entity tag for this subscription notification.
event_types[] list If present, only send notifications about listed event types. If empty, send notifications for all event types. writable
id string The ID of the notification.
kind string The kind of item this is. For notifications, this is always "storage#notification".
object_name_prefix string If present, only apply this notification configuration to object names that begin with this prefix. writable
payload_format string The desired content of the Payload.

Acceptable values are:
  • "JSON_API_V1"
  • "NONE"
topic string The Pub/Sub topic to which this subscription publishes. Formatted as: "//" writable


Permanently deletes a notification subscription.
View a notification configuration.
Creates a notification subscription for a given bucket.
Retrieves a list of notification subscriptions for a given bucket.