# mc event ls

LLMS index: [llms.txt](/llms.txt)

---

<a id="mc-event-ls"></a>
<a id="minio-mc-event-list"></a>

<a id="command-mc.event.list"></a>

<a id="command-mc.event.ls"></a>

## Syntax {#syntax}

The [`mc event ls`](#command-mc.event.ls) command lists all event notification triggers for a bucket.

The alias [`mc event list`](#command-mc.event.list) has equivalent functionality to [`mc event ls`](#command-mc.event.ls).

**EXAMPLE**

The following command lists all configured event notifications for the specified [bucket notification target](/administration/monitoring/bucket-notifications/#minio-bucket-notifications) for the `mydata` bucket on the `myminio` MinIO deployment:

```shell
mc event ls myminio myminio/mydata arn:aws:sqs::primary:target
```

**SYNTAX**

The command has the following syntax:

```shell
mc [GLOBALFLAGS]
```

- Brackets `[]` indicate optional parameters.
- Parameters sharing a line are mutually dependent.
- Parameters separated using the pipe `|` operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

```shell
mc [GLOBALFLAGS] event ls [FLAGS] ALIAS ARN
```

### Parameters {#parameters}

##### `ALIAS` {#mc.event.ls.ALIAS}

*mc-cmd*

*Required*

The S3 service [alias](/reference/minio-mc/mc-alias-set/#alias) and bucket to which the command lists event notification. For example:

```shell
mc event ls play/mybucket ARN...
```

##### `ARN` {#mc.event.ls.ARN}

*mc-cmd*

*Required*

The [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns) of the bucket resource.

The MinIO server outputs an ARN at startup for each configured notification target. See [Bucket Notifications](/administration/monitoring/bucket-notifications/#minio-bucket-notifications) for more information.

### Global Flags {#global-flags}

This command supports any of the [global flags](/reference/minio-mc/#minio-mc-global-options).

## Examples {#examples}

### List Event Notifications on a Bucket {#list-event-notifications-on-a-bucket}

**Example**

The following command lists all event notification triggers on a bucket.

```shell
mc event ls myminio/mydata
```

**Syntax**

```shell
mc event ls ALIAS ARN
```

- Replace `ALIAS` with the [alias](/reference/minio-mc/mc-alias-set/#alias) of the MinIO deployment on which to add the bucket notification event. For example:

  `myminio/mydata`
- Replace `ARN` with the notification target [`ARN`](/reference/minio-mc/mc-event-add/#mc.event.add.ARN).

## Behavior {#behavior}

### S3 Compatibility {#s3-compatibility}

SILO is the supported server for PGSTY mcli; compatibility with upstream MinIO and other S3 services is [best effort](/reference/minio-mc/#command-mc).