mirror of
https://github.com/minio/docs.git
synced 2025-08-09 13:02:53 +03:00
76e5e35ab3
Closes #1191 # Summary Finally getting around to this mc release - Added docs for enc-c, enc-s3, enc-kms - Some docs are making assumptions around behavior that needs to be fixed _first_ - Drive-by linker fixes Staged: http://192.241.195.202:9000/staging/DOCS-1191/linux/index.html --------- Co-authored-by: Andrea Longo <feorlen@users.noreply.github.com> Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
109 lines
2.8 KiB
ReStructuredText
109 lines
2.8 KiB
ReStructuredText
==========
|
|
``mc get``
|
|
==========
|
|
|
|
.. default-domain:: minio
|
|
|
|
.. contents:: Table of Contents
|
|
:local:
|
|
:depth: 2
|
|
|
|
.. mc:: mc get
|
|
|
|
.. versionadded:: mc RELEASE.2024-02-24T01-33-20Z
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. start-mc-get-desc
|
|
|
|
The :mc:`mc get` command downloads an object from a target S3 deployment to the local file system.
|
|
|
|
.. end-mc-get-desc
|
|
|
|
``mc get`` provides a simplified interface for downloading files compared to :mc:`mc cp` or :mc:`mc mirror`.
|
|
``mc get`` uses a one-way download function that trades efficiency for the power and complexity of the other commands.
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: EXAMPLE
|
|
|
|
The following downloads the file ``logo.png`` from an s3 source to the local file system at path ``~/images/collateral/``.
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc get minio/marketing/logo.png ~/images/collateral
|
|
|
|
|
|
.. tab-item:: SYNTAX
|
|
|
|
The command has the following syntax:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc [GLOBALFLAGS] get \
|
|
SOURCE \
|
|
TARGET \
|
|
[--enc-c string] \
|
|
[--version-id, --vid value]
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-syntax
|
|
:end-before: end-minio-syntax
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
.. mc-cmd:: SOURCE
|
|
:required:
|
|
|
|
The full path to the :ref:`alias <minio-mc-alias>`, bucket, prefix (if used), and object to download.
|
|
|
|
.. mc-cmd:: TARGET
|
|
:required:
|
|
|
|
The destination path on the local file system where the command should place the downloaded file.
|
|
|
|
.. block include of enc-c
|
|
|
|
.. include:: /includes/common-minio-sse.rst
|
|
:start-after: start-minio-mc-sse-c-only
|
|
:end-before: end-minio-mc-sse-options
|
|
|
|
.. mc-cmd:: --version-id, --vid
|
|
:optional:
|
|
|
|
Retrieve a specific version of the object.
|
|
Pass the version ID of the object to retrieve.
|
|
|
|
Global Flags
|
|
~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-globals
|
|
:end-before: end-minio-mc-globals
|
|
|
|
Examples
|
|
--------
|
|
|
|
Retrieve an object from MinIO to the local file system
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The following command retrieves the file ``myobject.csv`` from the bucket ``mybucket`` at the alias ``myminio`` and places it on the local file system at the path ``/my/local/folder``.
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc get myminio/mybucket/myobject.csv /my/local/folder
|
|
|
|
Retrieve an encrypted object from MinIO
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The following command retrieves an encrypted file and places it at a local folder path.
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc get --enc-c "play/mybucket/object=MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDA" play/mybucket/object path-to/object |