mirror of
https://github.com/minio/docs.git
synced 2025-07-28 19:42:10 +03:00
a6d554acdc
Closes #807 Closes #846 --------- Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
135 lines
3.2 KiB
ReStructuredText
135 lines
3.2 KiB
ReStructuredText
===================
|
|
``mc share ls``
|
|
===================
|
|
|
|
.. default-domain:: minio
|
|
|
|
.. contents:: Table of Contents
|
|
:local:
|
|
:depth: 2
|
|
|
|
.. mc:: mc share list
|
|
.. mc:: mc share ls
|
|
|
|
Syntax
|
|
-----------
|
|
|
|
.. start-mc-share-list-desc
|
|
|
|
The :mc:`mc share ls` command displays any unexpired presigned URLs generated
|
|
by :mc:`mc share upload` or :mc:`mc share download`
|
|
|
|
.. end-mc-share-list-desc
|
|
|
|
The :mc:`mc share list` command has equivalent functionality to :mc:`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 :aws-docs:`Pre-Signed URLs
|
|
<AmazonS3/latest/dev/ShareObjectPreSignedURL.html>`.
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: EXAMPLE
|
|
|
|
The following command lists all upload and download presigned URLs
|
|
respectively for the ``mydata`` bucket on the ``myminio`` MinIO
|
|
deployment:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc share ls upload myminio/mydata
|
|
mc share ls download myminio/mydata
|
|
|
|
.. tab-item:: SYNTAX
|
|
|
|
The command has the following syntax:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc [GLOBALFLAGS] share list \
|
|
[download | upload] \
|
|
ALIAS
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-syntax
|
|
:end-before: end-minio-syntax
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
.. mc-cmd:: download
|
|
|
|
*Required* Lists all unexpired presigned download (``GET``) URLs.
|
|
|
|
Mutually exclusive with :mc:`mc share ls upload`
|
|
|
|
.. mc-cmd:: upload
|
|
|
|
*Required* Lists all unexpired presigned upload (``PUT``) URLs.
|
|
|
|
Mutually exclusive with :mc:`mc share ls download`
|
|
|
|
.. mc-cmd:: ALIAS
|
|
|
|
*Required* The :ref:`alias <alias>` of a MinIO deplyment and the full path to
|
|
the object for which to list unexpired presigned URLs.
|
|
|
|
|
|
|
|
Global Flags
|
|
~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-globals
|
|
:end-before: end-minio-mc-globals
|
|
|
|
Examples
|
|
--------
|
|
|
|
List Generated Download and Upload URLs
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: List Active Download Presigned URLs
|
|
|
|
Use :mc:`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:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc share ls download ALIAS
|
|
|
|
- Replace :mc-cmd:`ALIAS <mc share ls ALIAS>` with the
|
|
:ref:`alias <alias>` of the MinIO deployment.
|
|
|
|
.. tab-item:: List Active Upload Presigned URLs
|
|
|
|
Use :mc:`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:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc share ls upload ALIAS
|
|
|
|
- Replace :mc-cmd:`ALIAS <mc share upload ALIAS>` with the
|
|
:ref:`alias <alias>` of the MinIO deployment.
|
|
|
|
Behavior
|
|
--------
|
|
|
|
S3 Compatibility
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-s3-compatibility
|
|
:end-before: end-minio-mc-s3-compatibility
|