# mc share ls

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

---

<a id="mc-share-ls"></a>

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

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

## Syntax {#syntax}

The [`mc share ls`](#command-mc.share.ls) command displays any unexpired presigned URLs generated by [`mc share upload`](/reference/minio-mc/mc-share-upload/#command-mc.share.upload) or [`mc share download`](/reference/minio-mc/mc-share-download/#command-mc.share.download)

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

Applications can perform a `PUT` to retrieve the object from the URL.

For more information on shareable object URLs, see the Amazon S3 documentation on [Pre-Signed URLs](https://docs.aws.amazon.com/AmazonS3/latest/dev/ShareObjectPreSignedURL.html).

**EXAMPLE**

The following command lists all upload and download presigned URLs respectively for the `mydata` bucket on the `myminio` MinIO deployment:

```shell
mc share ls upload myminio/mydata
mc share ls download myminio/mydata
```

**SYNTAX**

The command has the following syntax:

```shell
mc [GLOBALFLAGS] share list           \
                 [download | upload]  \
                 ALIAS
```

- 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.

### Parameters {#parameters}

##### `download` {#mc.share.ls.download}

*mc-cmd*

*Required* Lists all unexpired presigned download (`GET`) URLs.

Mutually exclusive with [`mc share ls upload`](#mc.share.ls.upload)

##### `upload` {#mc.share.ls.upload}

*mc-cmd*

*Required* Lists all unexpired presigned upload (`PUT`) URLs.

Mutually exclusive with [`mc share ls download`](#mc.share.ls.download)

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

*mc-cmd*

*Required* The [alias](/reference/minio-mc/mc-alias-set/#alias) of a MinIO deplyment and the full path to the object for which to list unexpired presigned URLs.

### Global Flags {#global-flags}

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

## Examples {#examples}

### List Generated Download and Upload URLs {#list-generated-download-and-upload-urls}

**List Active Download Presigned URLs**

Use [`mc share ls download`](#mc.share.ls.download) to generate a URL that supports `POST` requests for uploading a file to a specific object location on an S3-compatible host:

```shell
mc share ls download ALIAS
```

- Replace [`ALIAS`](#mc.share.ls.ALIAS) with the [alias](/reference/minio-mc/mc-alias-set/#alias) of the MinIO deployment.

**List Active Upload Presigned URLs**

Use [`mc share ls upload`](#mc.share.ls.upload) to generate a URL that supports `POST` requests for uploading a file to a specific object location on an S3-compatible host:

```shell
mc share ls upload ALIAS
```

- Replace [`ALIAS`](/reference/minio-mc/mc-share-upload/#mc.share.upload.ALIAS) with the [alias](/reference/minio-mc/mc-alias-set/#alias) of the MinIO deployment.

## 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).