minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-07-30 07:03:26 +03:00
Code Activity
Files
3fec026a95f48adfaf413d79fc8aa5facefbff73
docs/source/reference/minio-mc/mc-share-download.rst
Andrea Longo 08eb7770dc Small docs fixes and cleanups (#1138) 
Many small fixes:
- Clarify that `mc legalhold set --recursive` applies to current objects
only. Go back and do it again if you want it to apply to newly created
objects.
- Clean up inconsistent capitalization of "legal hold."
- Fix a bunch more `:required:` and `:optional:`
- Add a resync step to the restore site replication instructions

Staged:

http://192.241.195.202:9000/staging/small-clarifications/linux/index.html
2024-02-23 11:37:53 -07:00

5.1 KiB
Raw Blame History

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 download           \
                 [--expire "string"]      \
                 [--recursive]            \
                 [--version-id "string"]  \
                 ALIAS

Parameters

ALIAS

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

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

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