Cloud Storage Client - Class Notification (1.31.2)

Reference documentation and code samples for the Cloud Storage Client class Notification.

Cloud Pub/Sub Notifications sends information about changes to objects in your buckets to Google Cloud Pub/Sub, where the information is added to a Cloud Pub/Sub topic of your choice in the form of messages. For example, you can track objects that are created and deleted in your bucket. Each notification contains information describing both the event that triggered it and the object that changed.

To utilize this class and see more examples, please see the relevant notifications based methods exposed on Google\Cloud\Storage\Google\Cloud\Storage\Bucket .

Example:

 use Google\Cloud\Storage\StorageClient;

$storage = new StorageClient();

// Fetch an existing notification by ID.
$bucket = $storage->bucket('my-bucket');
$notification = $bucket->notification('2482'); 

Check whether or not the notification exists.

Example:

 if ($notification->exists()) {
    echo 'Notification exists!';
} 

Delete the notification.

Example:

 $notification->delete(); 

Retrieves the notification's details. If no notification data is cached a network request will be made to retrieve it.

Example:

 $info = $notification->info();
echo $info['topic']; 

Triggers a network request to reload the notification's details.

Example:

 $notification->reload();
$info = $notification->info();
echo $info['topic']; 

Retrieves the notification's ID.

Example:

 echo $notification->id(); 

Retrieves the notification's identity.

Example:

 echo $notification->identity()['bucket'];