mc share list

The mc share ls command displays any unexpired presigned URLs generated by mc share upload or mc share download.

The mc share list command has equivalent functionality to mc share ls.

Applications use a GET request against a download URL to retrieve an object, or a PUT request against an upload URL to store one.

For more information on shareable object URLs, see the Amazon S3 documentation on Pre-Signed URLs.

Syntax

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] share list  \
                 download | upload

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

download

Required

Lists all unexpired presigned download (GET) URLs.

Mutually exclusive with mc share ls upload.

upload

Required

Lists all unexpired presigned upload (PUT) URLs.

Mutually exclusive with mc share ls download.

Global flags

This command supports any of the global flags.

Examples

List active download presigned URLs

Use mc share ls download to list all unexpired presigned download (GET) URLs created by mc share download:

mc share ls download

List active upload presigned URLs

Use mc share ls upload to list all unexpired presigned upload (PUT) URLs created by mc share upload:

mc share ls upload

Behavior

S3 compatibility

The mc command-line tool is built for compatibility with the AWS S3 API and is tested with MinIO AIStor 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.