mirror of
https://github.com/minio/docs.git
synced 2025-08-06 14:42:56 +03:00
0747c9a191
Came up in a customer issue. Specifically the threshold is 4 kb and there is no configuration option. (Nor does Klaus want one.) Worth adding? With how much detail? The threshold choice is because of typical block size on disk. You will use at least that much anyway so why bother compressing. Staged: http://192.241.195.202:9000/staging/dont-compress-small-objects/linux/administration/object-management/data-compression.html#excluded-file-types Drive-by fix tacked onto this PR: correct typos in some `mc anonymous` examples. Staged: http://192.241.195.202:9000/staging/dont-compress-small-objects/linux/reference/minio-mc/mc-anonymous.html --------- Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com> Co-authored-by: Ravind Kumar <ravind@min.io>
140 lines
3.7 KiB
ReStructuredText
140 lines
3.7 KiB
ReStructuredText
.. _minio-mc-policy-set:
|
|
.. _minio-mc-anonymous-set:
|
|
|
|
====================
|
|
``mc anonymous set``
|
|
====================
|
|
|
|
.. default-domain:: minio
|
|
|
|
.. contents:: Table of Contents
|
|
:local:
|
|
:depth: 2
|
|
|
|
.. mc:: mc anonymous set
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. start-mc-anonymous-set-desc
|
|
|
|
The :mc:`mc anonymous set` command sets anonymous (i.e. unauthenticated or public)
|
|
access :ref:`policies <minio-policy>` for a bucket.
|
|
|
|
.. end-mc-anonymous-set-desc
|
|
|
|
Buckets with anonymous policies allow clients to access the bucket contents
|
|
and perform actions consistent with the specified policy without
|
|
:ref:`authentication <minio-authentication-and-identity-management>`.
|
|
|
|
To set anonymous bucket policies using an IAM
|
|
:s3-docs:`JSON policy <using-iam-policies>`, use the
|
|
:mc-cmd:`mc anonymous set-json` command.
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: EXAMPLE
|
|
|
|
The following command sets anonymous access policies for several
|
|
buckets on the ``myminio`` MinIO deployment:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc anonymous set upload myminio/uploads
|
|
mc anonymous set download myminio/downloads
|
|
mc anonymous set public myminio/public
|
|
|
|
Applications can perform the following operations without authentication:
|
|
|
|
- ``PUT`` objects to ``myminio/uploads`` and ``myminio/public``.
|
|
- ``GET`` objects from ``myminio/downloads`` and ``myminio/public``.
|
|
|
|
.. tab-item:: SYNTAX
|
|
|
|
The command has the following syntax:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc [GLOBALFLAGS] policy set PERMISSION ALIAS
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-syntax
|
|
:end-before: end-minio-syntax
|
|
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
.. mc-cmd:: PERMISSION
|
|
|
|
*Required* Name of the policy to assign to the specified ``ALIAS``.
|
|
Specify one of the following values:
|
|
|
|
- ``none`` - Disable anonymous access to the ``ALIAS``.
|
|
- ``download`` - Enable download-only access to the ``ALIAS``.
|
|
- ``upload`` - Enable upload-only access to the ``ALIAS``.
|
|
- ``public`` - Enable download and upload access to the ``ALIAS``.
|
|
|
|
.. mc-cmd:: ALIAS
|
|
|
|
*Required* The full path to the bucket or bucket prefix to which the
|
|
command applies the specified :mc-cmd:`~mc anonymous set PERMISSION`.
|
|
|
|
Specify the :ref:`alias <alias>` of the MinIO or other
|
|
S3-compatible service *and* the full path to the bucket or bucket
|
|
prefix. For example:
|
|
|
|
.. code-block:: shell
|
|
|
|
mc anonymous set public play/mybucket
|
|
|
|
Specify a bucket prefix to set the policy on only that prefix. For example,
|
|
this command sets distinct anonymous bucket policies on the
|
|
``mybucket/downloads`` and ``mybucket/uploads`` prefixes:
|
|
|
|
.. code-block:: shell
|
|
|
|
mc anonymous set download play/mybucket/downloads
|
|
mc anonymous set upload play/mybucket/uploads
|
|
|
|
Global Flags
|
|
~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-globals
|
|
:end-before: end-minio-mc-globals
|
|
|
|
Examples
|
|
--------
|
|
|
|
Set Anonymous Policy for Bucket
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Use :mc:`mc anonymous set` to set the anonymous policy for a
|
|
bucket:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc anonymous set POLICY ALIAS/PATH
|
|
|
|
- Replace :mc-cmd:`POLICY <mc anonymous set PERMISSION>` with a supported
|
|
:mc-cmd:`permission <mc anonymous set PERMISSION>`.
|
|
|
|
- Replace :mc-cmd:`ALIAS <mc anonymous set ALIAS>` with the
|
|
:mc-cmd:`alias <mc alias>` of a configured S3-compatible host.
|
|
|
|
- Replace :mc-cmd:`PATH <mc anonymous set ALIAS>` with the destination bucket.
|
|
|
|
Behavior
|
|
--------
|
|
|
|
S3 Compatibility
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-s3-compatibility
|
|
:end-before: end-minio-mc-s3-compatibility
|