docs/source/reference/minio-mc/mc-share-download.rst

mc share download

minio

Table of Contents

mc share download

Syntax

The mc share download command generates a temporary presigned URL with integrated access credentials for downloading objects from a MinIO bucket. The temporary URL expires after a configurable time limit.

• Applications can perform a GET to retrieve the object from the URL.
• Users can open the URL in a browser to download the object.

For more information on shareable object URLs, see the Amazon S3 documentation on Pre-Signed URLs <AmazonS3/latest/dev/ShareObjectPreSignedURL.html>.

EXAMPLE

The following command generates a new presigned download URL for the mydata bucket on the myminio MinIO deployment:

mc share download --recursive myminio/mydata

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] share upload             \
                 [--expire "string"]      \
                 [--recursive]            \
                 [--version-id "string"]  \
                 ALIAS

Parameters

ALIAS

Required The alias <alias> of a MinIO deplyment and the full path to the object for which to generate a download URL. For example:

mc share download play/mybucket/object.txt

You can specify multiple objects on the same or different MinIO deployments. For example:

mc share download play/mybucket/object.txt play/mybucket/otherobject.txt

If specifying the path to a bucket or bucket prefix, you must also specify the ~mc share download --recursive argument. For example:

mc share download --recursive play/mybucket/

mc share download --recursive play/mybucket/myprefix/

--expire, E

Optional Set the expiration time limit for all generated URLs.

Specify a string with format ##h##m##s format. For example: 12h34m56s for an expiry of 12 hours, 34 minutes, and 56 seconds after URL generation.

Defaults to 168h or 168 hours (7 days).

--recursive, r

Optional Recursively generate URLs for all objects in a mc share download ALIAS bucket or bucket prefix.

Required if any ALIAS specifies a path to a bucket or bucket prefix.

--version-id, vid

Global Flags

Examples

Generate a URL to Download Object(s)

Get Specific Object

Use mc share download to generate a URL that supports GET requests for an object:

mc share download --expire DURATION ALIAS/PATH

• Replace ALIAS <mc share download ALIAS> with the alias <alias> of the MinIO deployment.
• Replace PATH <mc share download ALIAS> with the path to the object on the MinIO deployment.
• Replace DURATION <mc share download --expire> with the duration after which the URL expires. For example, to set a 30 day expiry, specify 30d.

Get Object(s) in a Bucket

Use mc share download with the ~mc share download --recursive option to generate a URL for each object in a bucket. Each URL supports GET requests for its associated object:

mc share download --recursive --expire DURATION ALIAS/PATH

• Replace ALIAS <mc share download ALIAS> with the alias <alias> of the MinIO deployment.
• Replace PATH <mc share download ALIAS> with the path to the bucket or bucket prefix on the MinIO deployment.
• Replace DURATION <mc share download --expire> with the duration after which the URL expires. For example, to set a 30 day expiry, specify 30d.

Behavior

S3 Compatibility