Class BucketNotification (2.15.0)

Version 2.15.0

• 3.0.0-rc1 (latest)
• 2.19.0
• 2.17.0
• 2.16.0
• 2.15.0
• 2.14.0
• 2.13.0
• 2.12.0
• 2.11.0
• 2.10.0
• 2.9.0
• 2.8.0
• 2.7.0
• 2.6.0
• 2.5.0
• 2.4.0
• 2.3.0
• 2.2.1
• 2.1.0
• 2.0.0
• 1.44.0
• 1.43.0
• 1.42.3
• 1.41.1
• 1.40.0
• 1.39.0
• 1.38.0
• 1.37.1
• 1.36.2
• 1.35.1
• 1.34.0
• 1.33.0
• 1.32.0
• 1.31.2
• 1.30.0
• 1.29.0
• 1.28.1
• 1.27.0
• 1.26.0
• 1.25.0
• 1.24.1
• 1.23.0
• 1.22.0
• 1.21.0
• 1.20.0
• 1.19.0
• 1.18.0
• 1.17.0

BucketNotification(
    bucket,
    topic_name=None,
    topic_project=None,
    custom_attributes=None,
    event_types=None,
    blob_name_prefix=None,
    payload_format="NONE",
    notification_id=None,
)

Represent a single notification resource for a bucket.

See: https://cloud.google.com/storage/docs/json_api/v1/notifications

Parameters
Name	Description
bucket	Bucket Bucket to which the notification is bound.
topic_name	str (Optional) Topic name to which notifications are published.
topic_project	str (Optional) Project ID of topic to which notifications are published. If not passed, uses the project ID of the bucket's client.
custom_attributes	dict (Optional) Additional attributes passed with notification events.
event_types	list(str) (Optional) Event types for which notification events are published.
blob_name_prefix	str (Optional) Prefix of blob names for which notification events are published.
payload_format	str (Optional) Format of payload for notification events.
notification_id	str (Optional) The ID of the notification.

Properties

blob_name_prefix

Prefix of blob names for which notification events are published.

bucket

Bucket to which the notification is bound.

client

The client bound to this notfication.

custom_attributes

Custom attributes passed with notification events.

etag

Server-set ETag of notification resource.

event_types

Event types for which notification events are published.

notification_id

Server-set ID of notification resource.

path

The URL path for this notification.

payload_format

Format of payload of notification events.

self_link

Server-set ETag of notification resource.

topic_name

Topic name to which notifications are published.

topic_project

Project ID of topic to which notifications are published.

Methods

create

create(client=None, timeout=60, retry=None)

API wrapper: create the notification.

See: https://cloud.google.com/storage/docs/json_api/v1/notifications/insert

If user_project is set on the bucket, bills the API request to that project.

Parameters
Name	Description
client	Client (Optional) The client to use. If not passed, falls back to the client stored on the notification's bucket.
timeout	float or tuple (Optional) The amount of time, in seconds, to wait for the server response. See: configuring_timeouts
retry	google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy (Optional) How to retry the RPC. See: configuring_retries

Exceptions
Type	Description
ValueError	if the notification already exists.

delete

delete(client=None, timeout=60, retry=<google.api_core.retry.retry_unary.Retry object>)

Delete this notification.

See: https://cloud.google.com/storage/docs/json_api/v1/notifications/delete

If user_project is set on the bucket, bills the API request to that project.

Parameters
Name	Description
client	Client or NoneType (Optional) The client to use. If not passed, falls back to the client stored on the current bucket.
timeout	float or tuple (Optional) The amount of time, in seconds, to wait for the server response. See: configuring_timeouts
retry	google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy (Optional) How to retry the RPC. See: configuring_retries

Exceptions
Type	Description
google.api_core.exceptions.NotFound	if the notification does not exist.
ValueError	if the notification has no ID.

exists

exists(client=None, timeout=60, retry=<google.api_core.retry.retry_unary.Retry object>)

Test whether this notification exists.

See: https://cloud.google.com/storage/docs/json_api/v1/notifications/get

If user_project is set on the bucket, bills the API request to that project.

Parameters
Name	Description
client	Client or NoneType (Optional) The client to use. If not passed, falls back to the client stored on the current bucket.
timeout	float or tuple (Optional) The amount of time, in seconds, to wait for the server response. See: configuring_timeouts
retry	google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy (Optional) How to retry the RPC. See: configuring_retries

Exceptions
Type	Description
ValueError	if the notification has no ID.

Returns
Type	Description
bool	True, if the notification exists, else False.

from_api_repr

from_api_repr(resource, bucket)

Construct an instance from the JSON repr returned by the server.

See: https://cloud.google.com/storage/docs/json_api/v1/notifications

Parameters
Name	Description
resource	dict JSON repr of the notification
bucket	Bucket Bucket to which the notification is bound.

Returns
Type	Description
BucketNotification	the new notification instance

reload

reload(client=None, timeout=60, retry=<google.api_core.retry.retry_unary.Retry object>)

Update this notification from the server configuration.

See: https://cloud.google.com/storage/docs/json_api/v1/notifications/get

If user_project is set on the bucket, bills the API request to that project.

Parameters
Name	Description
client	Client or NoneType (Optional) The client to use. If not passed, falls back to the client stored on the current bucket.
timeout	float or tuple (Optional) The amount of time, in seconds, to wait for the server response. See: configuring_timeouts
retry	google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy (Optional) How to retry the RPC. See: configuring_retries

Exceptions
Type	Description
ValueError	if the notification has no ID.