1
0
mirror of https://github.com/minio/docs.git synced 2025-07-28 19:42:10 +03:00
Created common bucket notification for includes
Add include to the bucket notification `Publish Events to <service>` files.

Wording update, numbering fixes for bucket notifications

Adding .DS_Store to `gitignore`.

Ignoring .DS_Store

Delete .DS_Store
This commit is contained in:
Daryl White
2022-03-23 15:41:40 -05:00
committed by Ravind Kumar
parent 4d473c758b
commit 3d7d122aea
14 changed files with 145 additions and 82 deletions

3
.gitignore vendored
View File

@ -8,4 +8,5 @@ npm-debug.log
main.min.css main.min.css
main.css main.css
objects.inv objects.inv
output.log output.log
.DS_Store

View File

@ -0,0 +1,36 @@
.. start-bucket-notification-find-arn
.. admonition:: Identifying the ARN for your bucket notifications
:class: note
You defined the ``<IDENTIFIER>`` to assign to the target ARN for your bucket notifications when creating the endpoint previously.
The steps below return the ARNs configured on the deployment.
Identify the ARN created previously by looking for the ``<IDENTIFIER>`` you specified.
**Review the JSON output**
#. Copy and run the following command, replacing ``ALIAS`` with the :ref:`alias <alias>` of the deployment.
.. code-block:: shell
:class: copyable
mc admin info --json ALIAS
#. In the JSON output, look for the key ``info.sqsARN``.
The ARN you need is the value of that key that matches the ``<IDENTIFIER>`` you specified.
For example, |ARN|.
**Use jq to parse the JSON for the value**
#. `Install jq <https://stedolan.github.io/jq/>`_
#. Copy and run the following command, replacing ``ALIAS`` with the :ref:`alias <alias>` of the deployment.
.. code-block:: shell
:class: copyable
mc admin info --json ALIAS | jq .info.sqsARN
This returns the ARN to use for notifications, such as |ARN|
.. end-bucket-notification-find-arn

View File

@ -10,9 +10,8 @@ Bucket Notifications
:local: :local:
:depth: 2 :depth: 2
MinIO bucket notifications allow administrators to send notifications to MinIO bucket notifications allow administrators to send notifications to supported external services on certain object or bucket events.
supported external services on certain object or bucket events. MinIO MinIO supports bucket and object-level S3 events similar to the
supports bucket and object-level S3 events similar to the
:s3-docs:`Amazon S3 Event Notifications <NotificationHowTo.html>`. :s3-docs:`Amazon S3 Event Notifications <NotificationHowTo.html>`.
Supported Notification Targets Supported Notification Targets
@ -35,8 +34,7 @@ MinIO supports publishing event notifications to the following targets:
See :ref:`minio-bucket-notifications-publish-amqp` for a tutorial. See :ref:`minio-bucket-notifications-publish-amqp` for a tutorial.
* - :guilabel:`MQTT` * - :guilabel:`MQTT`
- Publish notifications to an `MQTT <https://www.mqtt.org/>`__ - Publish notifications to an `MQTT <https://www.mqtt.org/>`__ service.
service.
See :ref:`minio-bucket-notifications-publish-mqtt` for a tutorial. See :ref:`minio-bucket-notifications-publish-mqtt` for a tutorial.
@ -50,13 +48,10 @@ MinIO supports publishing event notifications to the following targets:
See :ref:`minio-bucket-notifications-publish-nsq` for a tutorial See :ref:`minio-bucket-notifications-publish-nsq` for a tutorial
* - :guilabel:`Elasticsearch` * - :guilabel:`Elasticsearch`
- Publish notifications to a `Elasticsearch <https://www.elastic.co/>`__ - Publish notifications to a `Elasticsearch <https://www.elastic.co/>`__ service.
service.
See :ref:`minio-bucket-notifications-publish-elasticsearch` for a See :ref:`minio-bucket-notifications-publish-elasticsearch` for a tutorial.
tutorial.
* - :guilabel:`Kafka` * - :guilabel:`Kafka`
- Publish notifications to a `Kafka <https://kafka.apache.org/>`__ service. - Publish notifications to a `Kafka <https://kafka.apache.org/>`__ service.
@ -69,8 +64,7 @@ MinIO supports publishing event notifications to the following targets:
See :ref:`minio-bucket-notifications-publish-mysql` for a tutorial. See :ref:`minio-bucket-notifications-publish-mysql` for a tutorial.
* - :guilabel:`PostgreSQL` * - :guilabel:`PostgreSQL`
- Publish notifications to a `PostgreSQL <https://www.postgresql.org/>`__ - Publish notifications to a `PostgreSQL <https://www.postgresql.org/>`__ service.
service.
See :ref:`minio-bucket-notifications-publish-postgresql` for a tutorial. See :ref:`minio-bucket-notifications-publish-postgresql` for a tutorial.
@ -91,9 +85,8 @@ MinIO supports publishing event notifications to the following targets:
Supported S3 Event Types Supported S3 Event Types
------------------------ ------------------------
MinIO bucket notifications are compatible with MinIO bucket notifications are compatible with :s3-docs:`Amazon S3 Event Notifications <NotificationHowTo.html>`.
:s3-docs:`Amazon S3 Event Notifications <NotificationHowTo.html>`. This This section lists all supported events.
section lists all supported events.
Object Events Object Events
~~~~~~~~~~~~~ ~~~~~~~~~~~~~
@ -132,8 +125,7 @@ Specify the wildcard ``*`` character to select all events related to a prefix:
Replication Events Replication Events
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~
MinIO supports triggering notifications on the following S3 replication MinIO supports triggering notifications on the following S3 replication events:
events:
.. data:: s3:Replication:OperationCompletedReplication .. data:: s3:Replication:OperationCompletedReplication
.. data:: s3:Replication:OperationFailedReplication .. data:: s3:Replication:OperationFailedReplication
@ -148,8 +140,7 @@ Specify the wildcard ``*`` character to select all ``s3:Replication`` events:
ILM Transition Events ILM Transition Events
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~
MinIO supports triggering notifications on the following S3 ILM transition MinIO supports triggering notifications on the following S3 ILM transition events:
events:
.. data:: s3:ObjectRestore:Post .. data:: s3:ObjectRestore:Post
.. data:: s3:ObjectRestore:Completed .. data:: s3:ObjectRestore:Completed
@ -170,8 +161,7 @@ Global Events
~~~~~~~~~~~~~ ~~~~~~~~~~~~~
MinIO supports triggering notifications on the following global events. MinIO supports triggering notifications on the following global events.
You can only listen to these events through the :legacy:`ListenNotification You can only listen to these events through the :legacy:`ListenNotification <golang-client-api-reference.html#ListenNotification>` API:
<golang-client-api-reference.html#ListenNotification>` API:
.. data:: s3:BucketCreated .. data:: s3:BucketCreated
.. data:: s3:BucketRemoved .. data:: s3:BucketRemoved

View File

@ -6,6 +6,8 @@ Publish Events to AMQP (RabbitMQ)
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:amqp``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -182,6 +184,10 @@ target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated AMQP deployment as a target. the associated AMQP deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the AMQP Endpoint as a Target 3) Configure Bucket Notifications using the AMQP Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -337,7 +343,7 @@ target similar to the following:
SQS ARNs: arn:minio:sqs::primary:amqp SQS ARNs: arn:minio:sqs::primary:amqp
3) Validate the Changes 4) Validate the Changes
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on a bucket which has an event configuration using the updated Perform an action on a bucket which has an event configuration using the updated

View File

@ -6,6 +6,8 @@ Publish Events to Elasticsearch
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:elasticsearch``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -173,6 +175,11 @@ target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated Elasticsearch deployment as a target. the associated Elasticsearch deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the Elasticsearch Endpoint as a Target 3) Configure Bucket Notifications using the Elasticsearch Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -197,7 +204,7 @@ a given notification target:
.. code-block:: shell .. code-block:: shell
:class: copyable :class: copyable
mc event list ALIAS/BUCKET arn:minio:sqs::primary:Elasticsearch mc event list ALIAS/BUCKET arn:minio:sqs::primary:elasticsearch
4) Validate the Configured Events 4) Validate the Configured Events
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -317,7 +324,7 @@ Elasticsearch target similar to the following:
SQS ARNs: arn:minio:sqs::primary:elasticsearch SQS ARNs: arn:minio:sqs::primary:elasticsearch
3) Validate the Changes 4) Validate the Changes
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on a bucket which has an event configuration using the updated Perform an action on a bucket which has an event configuration using the updated

View File

@ -6,6 +6,8 @@ Publish Events to Kafka
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:kafka``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -180,6 +182,11 @@ Kafka target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated Kafka deployment as a target. the associated Kafka deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the Kafka Endpoint as a Target 3) Configure Bucket Notifications using the Kafka Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -6,6 +6,8 @@ Publish Events to MQTT
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:mqtt``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -185,7 +187,11 @@ target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated MQTT deployment as a target. the associated MQTT deployment as a target.
3) Configure Bucket Notifications using the MQTT Endpoint as a Target .. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
1) Configure Bucket Notifications using the MQTT Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use the :mc-cmd:`mc event add` command to add a new bucket notification Use the :mc-cmd:`mc event add` command to add a new bucket notification

View File

@ -6,6 +6,8 @@ Publish Events to MySQL
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:mysql``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -172,6 +174,10 @@ target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated MySQL deployment as a target. the associated MySQL deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the MySQL Endpoint as a Target 3) Configure Bucket Notifications using the MySQL Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -317,7 +323,7 @@ target similar to the following:
SQS ARNs: arn:minio:sqs::primary:mysql SQS ARNs: arn:minio:sqs::primary:mysql
3) Validate the Changes 4) Validate the Changes
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on a bucket which has an event configuration using the updated Perform an action on a bucket which has an event configuration using the updated

View File

@ -6,6 +6,8 @@ Publish Events to NATS
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:nats``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -172,6 +174,10 @@ target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated NATS deployment as a target. the associated NATS deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the NATS Endpoint as a Target 3) Configure Bucket Notifications using the NATS Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -6,6 +6,8 @@ Publish Events to NSQ
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:nsq``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -148,16 +150,18 @@ target similar to the following:
.. code-block:: shell .. code-block:: shell
SQS ARNs: arn:minio:sqs::primary:nsq SQS ARNs: |ARN|
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with the associated NSQ deployment as a target.
the associated NSQ deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the NSQ Endpoint as a Target 3) Configure Bucket Notifications using the NSQ Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use the :mc-cmd:`mc event add` command to add a new bucket notification Use the :mc-cmd:`mc event add` command to add a new bucket notification event with the configured NSQ service as a target:
event with the configured NSQ service as a target:
.. code-block:: shell .. code-block:: shell
:class: copyable :class: copyable
@ -166,13 +170,11 @@ event with the configured NSQ service as a target:
--event EVENTS --event EVENTS
- Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment. - Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment.
- Replace ``BUCKET`` with the name of the bucket in which to configure the - Replace ``BUCKET`` with the name of the bucket in which to configure the event.
event.
- Replace ``EVENTS`` with a comma-separated list of :ref:`events - Replace ``EVENTS`` with a comma-separated list of :ref:`events
<mc-event-supported-events>` for which MinIO triggers notifications. <mc-event-supported-events>` for which MinIO triggers notifications.
Use :mc-cmd:`mc event list` to view all configured bucket events for Use :mc-cmd:`mc event list` to view all configured bucket events for a given notification target:
a given notification target:
.. code-block:: shell .. code-block:: shell
:class: copyable :class: copyable
@ -182,15 +184,10 @@ a given notification target:
4) Validate the Configured Events 4) Validate the Configured Events
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on the bucket for which you configured the new event and Perform an action on the bucket for which you configured the new event and check the NSQ service for the notification data.
check the NSQ service for the notification data. The action required The action required depends on which :mc-cmd:`events <mc event add --event>` were specified when configuring the bucket notification.
depends on which :mc-cmd:`events <mc event add --event>` were specified
when configuring the bucket notification.
For example, if the bucket notification configuration includes the For example, if the bucket notification configuration includes the ``s3:ObjectCreated:Put`` event, you can use the :mc-cmd:`mc cp` command to create a new object in the bucket and trigger a notification.
``s3:ObjectCreated:Put`` event, you can use the
:mc-cmd:`mc cp` command to create a new object in the bucket and trigger
a notification.
.. code-block:: shell .. code-block:: shell
:class: copyable :class: copyable
@ -200,9 +197,7 @@ a notification.
Update an NSQ Endpoint in a MinIO Deployment Update an NSQ Endpoint in a MinIO Deployment
-------------------------------------------- --------------------------------------------
The following procedure updates an existing NSQ service endpoint for supporting The following procedure updates an existing NSQ service endpoint for supporting :ref:`bucket notifications <minio-bucket-notifications>` in a MinIO deployment.
:ref:`bucket notifications <minio-bucket-notifications>` in a MinIO
deployment.
Prerequisites Prerequisites
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~
@ -217,8 +212,7 @@ See the ``mc`` :ref:`Quickstart <mc-install>` for installation instructions.
1) List Configured NSQ Endpoints In The Deployment 1) List Configured NSQ Endpoints In The Deployment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use the :mc-cmd:`mc admin config get` command to list the currently Use the :mc-cmd:`mc admin config get` command to list the currently configured NSQ service endpoints in the deployment:
configured NSQ service endpoints in the deployment:
.. code-block:: shell .. code-block:: shell
:class: copyable :class: copyable
@ -234,20 +228,16 @@ The command output resembles the following:
notify_nsq:primary nsqd_address="https://nsq.example.com" queue_dir="" queue_limit="0" tls="off" tls_skip_verify="off" topic="" notify_nsq:primary nsqd_address="https://nsq.example.com" queue_dir="" queue_limit="0" tls="off" tls_skip_verify="off" topic=""
notify_nsq:secondary nsqd_address="https://nsq.example.com" queue_dir="" queue_limit="0" tls="off" tls_skip_verify="off" topic="" notify_nsq:secondary nsqd_address="https://nsq.example.com" queue_dir="" queue_limit="0" tls="off" tls_skip_verify="off" topic=""
The :mc-conf:`notify_nsq` key is the top-level configuration key for an The :mc-conf:`notify_nsq` key is the top-level configuration key for an :ref:`minio-server-config-bucket-notification-nsq`.
:ref:`minio-server-config-bucket-notification-nsq`. The :mc-conf:`nsqd_address The :mc-conf:`nsqd_address <notify_nsq.nsqd_address>` key specifies the NSQ service endpoint for the given `notify_nsq` key.
<notify_nsq.nsqd_address>` key specifies the NSQ service endpoint for the given The ``notify_nsq:<IDENTIFIER>`` suffix describes the unique identifier for that NSQ service endpoint.
`notify_nsq` key. The ``notify_nsq:<IDENTIFIER>`` suffix describes the unique
identifier for that NSQ service endpoint.
Note the identifier for the NSQ service endpoint you want to update for Note the identifier for the NSQ service endpoint you want to update for the next step.
the next step.
2) Update the NSQ Endpoint 2) Update the NSQ Endpoint
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use the :mc-cmd:`mc admin config set` command to set the new configuration Use the :mc-cmd:`mc admin config set` command to set the new configuration for the NSQ service endpoint:
for the NSQ service endpoint:
.. code-block:: shell .. code-block:: shell
:class: copyable :class: copyable
@ -261,11 +251,9 @@ for the NSQ service endpoint:
queue_limit="<string>" \ queue_limit="<string>" \
comment="<string>" comment="<string>"
The :mc-conf:`notify_nsq nsqd_address <notify_nsq.nsqd_address>` configuration The :mc-conf:`notify_nsq nsqd_address <notify_nsq.nsqd_address>` configuration setting is the *minimum* required for an NSQ service endpoint.
setting is the *minimum* required for an NSQ service endpoint. All other All other configuration settings are *optional*.
configuration settings are *optional*. See See :ref:`minio-server-config-bucket-notification-nsq` for a complete list of NSQ configuration settings.
:ref:`minio-server-config-bucket-notification-nsq` for a complete list of NSQ
configuration settings.
3) Restart the MinIO Deployment 3) Restart the MinIO Deployment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -278,28 +266,21 @@ Use the :mc-cmd:`mc admin service restart` command to restart the deployment.
mc admin service restart ALIAS mc admin service restart ALIAS
Replace ``ALIAS`` with the :ref:`alias <alias>` of the deployment to Replace ``ALIAS`` with the :ref:`alias <alias>` of the deployment to restart.
restart.
The :mc:`minio server` process prints a line on startup for each configured NSQ The :mc:`minio server` process prints a line on startup for each configured NSQ target similar to the following:
target similar to the following:
.. code-block:: shell .. code-block:: shell
SQS ARNs: arn:minio:sqs::primary:NSQ SQS ARNs: arn:minio:sqs::primary:NSQ
3) Validate the Changes 4) Validate the Changes
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on a bucket which has an event configuration using the updated Perform an action on a bucket which has an event configuration using the updated NSQ service endpoint and check the NSQ service for the notification data.
NSQ service endpoint and check the NSQ service for the notification data. The The action required depends on which :mc-cmd:`events <mc event add --event>` were specified when configuring the bucket notification.
action required depends on which :mc-cmd:`events <mc event add --event>` were
specified when configuring the bucket notification.
For example, if the bucket notification configuration includes the For example, if the bucket notification configuration includes the ``s3:ObjectCreated:Put`` event, you can use the :mc-cmd:`mc cp` command to create a new object in the bucket and trigger a notification.
``s3:ObjectCreated:Put`` event, you can use the
:mc-cmd:`mc cp` command to create a new object in the bucket and trigger
a notification.
.. code-block:: shell .. code-block:: shell
:class: copyable :class: copyable

View File

@ -6,6 +6,8 @@ Publish Events to PostgreSQL
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:postgresql``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -175,6 +177,10 @@ target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated PostgreSQL deployment as a target. the associated PostgreSQL deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the PostgreSQL Endpoint as a Target 3) Configure Bucket Notifications using the PostgreSQL Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -188,8 +194,7 @@ event with the configured PostgreSQL service as a target:
--event EVENTS --event EVENTS
- Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment. - Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment.
- Replace ``BUCKET`` with the name of the bucket in which to configure the - Replace ``BUCKET`` with the name of the bucket in which to configure the ßevent.
event.
- Replace ``EVENTS`` with a comma-separated list of :ref:`events - Replace ``EVENTS`` with a comma-separated list of :ref:`events
<mc-event-supported-events>` for which MinIO triggers notifications. <mc-event-supported-events>` for which MinIO triggers notifications.
@ -322,7 +327,7 @@ target similar to the following:
SQS ARNs: arn:minio:sqs::primary:postgresql SQS ARNs: arn:minio:sqs::primary:postgresql
3) Validate the Changes 4) Validate the Changes
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on a bucket which has an event configuration using the updated Perform an action on a bucket which has an event configuration using the updated

View File

@ -6,6 +6,8 @@ Publish Events to Redis
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:redis``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -155,6 +157,10 @@ target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated Redis deployment as a target. the associated Redis deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the Redis Endpoint as a Target 3) Configure Bucket Notifications using the Redis Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -290,7 +296,7 @@ target similar to the following:
SQS ARNs: arn:minio:sqs::primary:redis SQS ARNs: arn:minio:sqs::primary:redis
3) Validate the Changes 4) Validate the Changes
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on a bucket which has an event configuration using the updated Perform an action on a bucket which has an event configuration using the updated

View File

@ -6,6 +6,8 @@ Publish Events to Webhook
.. default-domain:: minio .. default-domain:: minio
.. |ARN| replace:: ``arn:minio:sqs::primary:webhook``
.. contents:: Table of Contents .. contents:: Table of Contents
:local: :local:
:depth: 1 :depth: 1
@ -153,6 +155,10 @@ Webhook target similar to the following:
You must specify the ARN resource when configuring bucket notifications with You must specify the ARN resource when configuring bucket notifications with
the associated Webhook deployment as a target. the associated Webhook deployment as a target.
.. include:: /includes/common-bucket-notifications.rst
:start-after: start-bucket-notification-find-arn
:end-before: end-bucket-notification-find-arn
3) Configure Bucket Notifications using the Webhook Endpoint as a Target 3) Configure Bucket Notifications using the Webhook Endpoint as a Target
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -288,7 +294,7 @@ target similar to the following:
SQS ARNs: arn:minio:sqs::primary:webhook SQS ARNs: arn:minio:sqs::primary:webhook
3) Validate the Changes 4) Validate the Changes
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
Perform an action on a bucket which has an event configuration using the updated Perform an action on a bucket which has an event configuration using the updated

View File

@ -191,7 +191,7 @@ corresponding :ref:`S3 events <minio-bucket-notifications-event-types>`:
:widths: 30 70 :widths: 30 70
:width: 100% :width: 100%
* - Supported Vluae * - Supported Value
- Corresponding S3 Events - Corresponding S3 Events
* - ``put`` * - ``put``