# 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}

The **`mc`** commandline tool is built for compatibility with the AWS S3 API and is tested with MinIO and AWS S3 for expected functionality and behavior.

MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While **`mc`** commands *may* work as documented, any such usage is at your own risk.