docs/source/reference/minio-mc/mc-anonymous-set.rst

mc anonymous set

minio

Table of Contents

mc anonymous

mc anonymous set

Syntax

The mc anonymous set command sets anonymous (i.e. unauthenticated or public) access policies <minio-policy> for a bucket.

Buckets with anonymous policies allow clients to access the bucket contents and perform actions consistent with the specified policy without authentication <minio-authentication-and-identity-management>.

To set anonymous bucket policies using an IAM JSON policy <using-iam-policies>, use the mc anonymous set-json command.

EXAMPLE

The following command sets anonymous access policies for several buckets on the myminio MinIO deployment:

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.

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] policy set PERMISSION ALIAS

Parameters

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.

ALIAS

Required The full path to the bucket or bucket prefix to which the command applies the specified ~mc anonymous set PERMISSION.

Specify the alias <alias> of the MinIO or other S3-compatible service and the full path to the bucket or bucket prefix. For example:

mc 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:

mc set download play/mybucket/downloads
mc set upload play/mybucket/uploads

Global Flags

Examples

Set Anonymous Policy for Bucket

Use mc anonymous set to set the anonymous policy for a bucket:

mc anonymous set POLICY ALIAS/PATH

• Replace POLICY <mc anonymous set PERMISSION> with a supported permission <mc anonymous set PERMISSION>.
• Replace ALIAS <mc anonymous set ALIAS> with the alias <mc alias> of a configured S3-compatible host.
• Replace PATH <mc anonymous set ALIAS> with the destination bucket.

Behavior

S3 Compatibility