VK Cloud logo

Managing webhooks

VK Object Storage allows you to configure notifications about adding or deleting an object from a bucket.

Adding a webhook

  1. Go to the VK Cloud management console.

  2. Select the project that contains the desired bucket.

  3. Go to the Object Storage → Buckets section.

  4. Open the bucket settings in one of the following ways:

    • Click  for the desired bucket and select Settings.
    • Click the name of the desired bucket, then click the  button on the bucket page.
  5. Go to the Webhooks tab and click the plus-icon Add button.

  6. Specify the webhook parameters:

    • ID: the webhook name. The name must be unique within a single bucket.

    • Event: events upon which a notification should be sent:

      • ObjectCreated — adding an object to the bucket by any method, includes the PutObject, PutObjectCopy, and CompleteMultipartUpload events;
      • PutObject — adding an object;
      • PutObjectCopy — adding a copy of an object;
      • CompleteMultipartUpload — adding an object using the multipart method;
      • ObjectRemoved — deleting an object by any method, includes the DeleteObject event;
      • DeleteObject — deleting an object.
    • URL: the address of the webhook receiving server. For example, http://83.166.234.90/webhook. To receive webhooks, ports 80 or 443 must be configured on the server.

    • Filter prefix: a filter that allows generating webhooks for events only for objects whose names contain the specified prefix. For example, if you enter the value images, webhooks will be sent when objects such as bucket\images\picture.png, bucket\images\picture.svg are modified. In the management console, the prefix is displayed as a directory.

    • Filter suffix: a filter that allows generating webhooks for events only for objects whose names contain the specified suffix. For example, if you enter the value png, webhooks will be sent when files with the .png extension are modified.

  7. Click the Add hook button.

You can study the webhook exchange mechanism in VK Object Storage in detail using the example of creating an event-driven application.

Editing a webhook

  1. Go to the VK Cloud management console.

  2. Select the project that contains the desired bucket.

  3. Go to the Object Storage → Buckets section.

  4. Open the bucket settings in one of the following ways:

    • Click  for the desired bucket and select Settings.
    • Click the name of the desired bucket, then click the  button on the bucket page.
  5. Go to the Webhooks tab.

  6. Click  for the desired webhook and select pencil-icon Edit hook.

  7. Edit the webhook parameters.

  8. Click the Save changes button.

Deleting a webhook

This is a group operation: if necessary, you can delete multiple webhooks by selecting them using checkboxes.

  1. Go to the VK Cloud management console.

  2. Select the project that contains the desired bucket.

  3. Go to the Object Storage → Buckets section.

  4. Open the bucket settings in one of the following ways:

    • Click  for the desired bucket and select Settings.
    • Click the name of the desired bucket, then click the  button on the bucket page.
  5. Go to the Webhooks tab.

  6. Delete the webhook in one of the following ways:

    • Click  for the desired webhook and select trash-icon Delete hook.
    • Check the checkbox for the desired webhook and click the trash-icon Delete button.
  7. Confirm the deletion.

Was this article helpful?