docs/source/reference/minio-mc/mc-policy-set-json.rst

mc policy set-json

minio

Table of Contents

mc policy set-json

Syntax

The mc policy set-json command sets anonymous (i.e. unauthenticated or public) access policies <minio-policy> for a bucket using using an IAM JSON policy document <using-iam-policies>.

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>.

EXAMPLE

The following command applies the JSON-formatted anonymous policy to the mydata bucket on the myminio MinIO deployment:

mc policy set-json ~/mydata-anonymous.json myminio/mydata

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] set-json POLICY ALIAS

Parameters

POLICY

Required The path to the JSON-formatted policy to assign to the specified ALIAS.

ALIAS

Required The full path to the bucket or bucket prefix to which the command applies the specified ~mc policy set-json POLICY.

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-json public play/mybucket

Global Flags

Examples

Set Anonymous Policy for Bucket

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

mc policy set-json POLICY ALIAS/PATH

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

Remove Anonymous Policy for Bucket

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

mc policy set none ALIAS/PATH

• Replace ALIAS <mc policy set ALIAS> with the alias <mc alias> of a configured S3-compatible host.
• Replace PATH <mc policy set ALIAS> with the destination bucket.

Behavior

S3 Compatibility