Class: Google::Cloud::Storage::Notification

Inherits:
Object
  • Object
show all
Defined in:
lib/google/cloud/storage/notification.rb

Overview

Notification

Represents a Pub/Sub notification subscription for a Cloud Storage bucket.

See Bucket#create_notification, Bucket#notifications, and Bucket#notification.

Examples:

require "google/cloud/pubsub"
require "google/cloud/storage"

pubsub = Google::Cloud::Pubsub.new
topic = pubsub.create_topic "my-topic"
topic.policy do |p|
  p.add "roles/pubsub.publisher",
        "serviceAccount:my-project" \
        "@gs-project-accounts.iam.gserviceaccount.com"
end

storage = Google::Cloud::Storage.new
bucket = storage.bucket "my-bucket"

notification = bucket.create_notification topic.name

See Also:

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#bucket ⇒ String (readonly)

The name of the Bucket to which this notification belongs.

Returns:

  • (String) —

    the current value of bucket



53
54
55
 
# File 'lib/google/cloud/storage/notification.rb', line 53

def bucket
  @bucket
end

Instance Method Details

#api_url ⇒ Object

A URL that can be used to access the notification using the REST API.



92
93
94
 
# File 'lib/google/cloud/storage/notification.rb', line 92

def api_url
  @gapi.self_link
end

#custom_attrs ⇒ Object

The custom attributes of this notification. An optional list of additional attributes to attach to each Cloud Pub/Sub message published for this notification subscription.



100
101
102
 
# File 'lib/google/cloud/storage/notification.rb', line 100

def custom_attrs
  @gapi.custom_attributes
end

#delete ⇒ Boolean

Permanently deletes the notification.

The API call to delete the notification may be retried under certain conditions. See Google::Cloud#storage to control this behavior.

Examples:

require "google/cloud/storage"

storage = Google::Cloud::Storage.new

bucket = storage.bucket "my-bucket"
notification = bucket.notification "1"
notification.delete

Returns:

  • (Boolean) —

    Returns true if the notification was deleted.



187
188
189
190
191
 
# File 'lib/google/cloud/storage/notification.rb', line 187

def delete
  ensure_service!
  @service.delete_notification bucket, id, user_project: @user_project
  true
end

#event_types ⇒ Object

The event types of this notification. If present, messages will only be sent for the listed event types. If empty, messages will be sent for all event types.

The following is a list of event types currently supported by Cloud Storage:

  • OBJECT_FINALIZE - Sent when a new object (or a new generation of an existing object) is successfully created in the bucket. This includes copying or rewriting an existing object. A failed upload does not trigger this event.
  • OBJECT_METADATA_UPDATE - Sent when the metadata of an existing object changes.
  • OBJECT_DELETE - Sent when an object has been permanently deleted. This includes objects that are overwritten or are deleted as part of the bucket's lifecycle configuration. For buckets with object versioning enabled, this is not sent when an object is archived (see OBJECT_ARCHIVE), even if archival occurs via the File#delete method.
  • OBJECT_ARCHIVE - Only sent when a bucket has enabled object versioning. This event indicates that the live version of an object has become an archived version, either because it was archived or because it was overwritten by the upload of an object of the same name.

Important: Additional event types may be released later. Client code should either safely ignore unrecognized event types, or else explicitly specify in their notification configuration which event types they are prepared to accept.



135
136
137
 
# File 'lib/google/cloud/storage/notification.rb', line 135

def event_types
  @gapi.event_types
end

#id ⇒ Object

The ID of the notification.



86
87
88
 
# File 'lib/google/cloud/storage/notification.rb', line 86

def id
  @gapi.id
end

#kind ⇒ Object

The kind of item this is. For notifications, this is always storage#notification.



80
81
82
 
# File 'lib/google/cloud/storage/notification.rb', line 80

def kind
  @gapi.kind
end

#payload ⇒ Object

The desired content of the Pub/Sub message payload. Acceptable values are:

  • JSON_API_V1 - The payload will be a UTF-8 string containing the resource representation of the file's metadata.
  • NONE - No payload is included with the notification.


158
159
160
 
# File 'lib/google/cloud/storage/notification.rb', line 158

def payload
  @gapi.payload_format
end

#prefix ⇒ Object

The file name prefix of this notification. If present, only apply this notification configuration to file names that begin with this prefix.



144
145
146
 
# File 'lib/google/cloud/storage/notification.rb', line 144

def prefix
  @gapi.object_name_prefix
end

#topic ⇒ Object

The Cloud Pub/Sub topic to which this subscription publishes. Formatted as: //pubsub.googleapis.com/projects/{project-id}/topics/{my-topic}



166
167
168
 
# File 'lib/google/cloud/storage/notification.rb', line 166

def topic
  @gapi.topic
end