1
0
mirror of https://github.com/minio/docs.git synced 2025-07-30 07:03:26 +03:00

DOCS-807, DOCS-846, Misc. Bug fixes (#861)

Closes #807 
Closes #846 


---------

Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
This commit is contained in:
Ravind Kumar
2023-05-23 17:29:48 -04:00
committed by GitHub
parent 423e38315e
commit a6d554acdc
49 changed files with 676 additions and 168 deletions

View File

@ -10,6 +10,7 @@
:local:
:depth: 2
.. mc:: mc ilm remove
.. mc:: mc ilm rm
.. versionchanged:: RELEASE.2022-12-24T15-21-38Z
@ -27,6 +28,8 @@ MinIO Bucket.
.. end-mc-ilm-rm-desc
The :mc:`mc ilm remove` command has equivalent functionality to :mc:`mc ilm rm`.
.. tab-set::
.. tab-item:: EXAMPLE

View File

@ -40,6 +40,16 @@ The following table lists :mc:`mc admin` commands:
:start-after: start-mc-admin-bucket-remote-desc
:end-before: end-mc-admin-bucket-remote-desc
* - :mc:`mc admin cluster bucket`
- .. include:: /reference/minio-mc-admin/mc-admin-cluster-bucket.rst
:start-after: start-mc-admin-cluster-bucket-desc
:end-before: end-mc-admin-cluster-bucket-desc
* - :mc:`mc admin cluster iam`
- .. include:: /reference/minio-mc-admin/mc-admin-cluster-iam.rst
:start-after: start-mc-admin-cluster-iam-desc
:end-before: end-mc-admin-cluster-iam-desc
* - :mc-cmd:`mc admin console`
- .. include:: /reference/minio-mc-admin/mc-admin-console.rst
:start-after: start-mc-admin-console-desc
@ -194,7 +204,9 @@ See :ref:`minio-mc-global-options`.
:hidden:
:glob:
/reference/minio-mc-admin/mc-admin-bucket-remote.rst
/reference/minio-mc-admin/mc-admin-bucket-remote
/reference/minio-mc-admin/mc-admin-cluster-bucket
/reference/minio-mc-admin/mc-admin-cluster-iam
/reference/minio-mc-admin/mc-admin-config
/reference/minio-mc-admin/mc-admin-console
/reference/minio-mc-admin/mc-admin-decommission

View File

@ -205,36 +205,11 @@ Syntax
- ``mc admin bucket remote ls`` replaced by :mc-cmd:`mc replicate ls`
Lists all remote targets associated to a bucket on the MinIO deployment. The
command has the following syntax:
.. code-block:: shell
:class: copyable
mc admin bucket remote ls SOURCE --service "replication"
The command accepts the following arguments:
.. mc-cmd:: SOURCE
The full path to the bucket for which the command returns the configured
remote targets. Specify the :mc-cmd:`alias <mc alias>` of a configured
MinIO deployment as the prefix to the bucket path. For example:
.. code-block:: shell
:class: copyable
mc admin bucket remote ls play/mybucket
.. mc-cmd:: --service
*Required*
Specify ``"replication"``.
Lists all remote targets associated to a bucket on the MinIO deployment.
Use ``mc admin bucket remote ls --help`` for usage syntax.
.. mc-cmd:: rm
.. mc-cmd:: rm, remove
:fullpath:
.. versionchanged:: RELEASE.2022-12-24T15-21-38Z

View File

@ -0,0 +1,72 @@
.. _minio-mc-admin-cluster-bucket-export:
==================================
``mc admin cluster bucket export``
==================================
.. default-domain:: minio
.. mc:: mc admin cluster bucket export
Description
-----------
.. versionadded:: RELEASE.2022-06-17T02-52-50Z
.. start-mc-admin-cluster-bucket-export-desc
The :mc:`mc admin cluster bucket export` command exports bucket metadata for use with the :mc:`mc admin cluster bucket import` command.
.. end-mc-admin-cluster-bucket-export-desc
You can use this command to manually back up the metadata for the specified MinIO bucket.
The command always saves the output as ``cluster-metadata.zip``.
If you specify only the deployment as the target, this command backs up all bucket metadata on the target deployment.
.. tab-set::
.. tab-item:: EXAMPLE
The following command exports all bucket metadata for the ``myminio`` deployment.
.. code-block:: shell
:class: copyable
mc admin cluster bucket export myminio
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin cluster bucket export \
ALIAS[/BUCKET]
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
:end-before: end-minio-syntax
Parameters
~~~~~~~~~~
.. mc-cmd:: ALIAS
:required:
The :mc-cmd:`alias <mc alias>` of the MinIO deployment.
.. mc-cmd:: BUCKET
:optional:
The bucket to export metadata for.
Global Flags
~~~~~~~~~~~~
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-mc-globals
:end-before: end-minio-mc-globals

View File

@ -0,0 +1,79 @@
.. _minio-mc-admin-cluster-bucket-import:
==================================
``mc admin cluster bucket import``
==================================
.. default-domain:: minio
.. mc:: mc admin cluster bucket import
Description
-----------
.. versionadded:: RELEASE.2022-06-17T02-52-50Z
.. start-mc-admin-cluster-bucket-import-desc
The :mc:`mc admin cluster bucket import` command imports bucket metadata as created by the :mc:`mc admin cluster bucket export` command.
.. end-mc-admin-cluster-bucket-import-desc
You can use this command to manually restore the metadata to the specified bucket on a MinIO deployment.
If you specify only the deployment as the target, this command applies the metadata objects to all matching buckets on the target.
.. tab-set::
.. tab-item:: EXAMPLE
The following command imports the specified metadata to the ``myminio`` deployment.
.. code-block:: shell
:class: copyable
mc admin cluster bucket import myminio ~/minio-metadata-backup/myminio-cluster.zip
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin cluster bucket import \
ALIAS[/BUCKET] \
METADATA.ZIP
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
:end-before: end-minio-syntax
Parameters
~~~~~~~~~~
.. mc-cmd:: ALIAS
:required:
The :mc-cmd:`alias <mc alias>` of the MinIO deployment.
.. mc-cmd:: METADATA.ZIP
:required:
The path to the metadata file to import.
Use :mc:`mc admin cluster bucket export` to export bucket metadata for use with this command.
.. mc-cmd:: BUCKET
:optional:
The bucket to apply the imported metadata to.
Global Flags
~~~~~~~~~~~~
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-mc-globals
:end-before: end-minio-mc-globals

View File

@ -0,0 +1,60 @@
.. _minio-mc-admin-cluster-bucket:
===========================
``mc admin cluster bucket``
===========================
.. default-domain:: minio
.. contents:: Table of Contents
:local:
:depth: 2
.. mc:: mc admin cluster bucket
Description
-----------
.. versionadded:: RELEASE.2022-06-17T02-52-50Z
.. start-mc-admin-cluster-bucket-desc
The :mc:`mc admin cluster bucket` command and its subcommands provide tools for manually importing and exporting MinIO bucket metadata.
.. end-mc-admin-cluster-bucket-desc
This metadata includes configurations related to features like :ref:`lifecycle management rules <minio-lifecycle-management>`.
You can use this metadata as a snapshot of the bucket configuration for restoration later, such as part of :abbr:`BC/DR (Business Continuity / Disaster Recovery)` or backup/restore operations.
You can use this command on individual buckets *or* on all buckets in a MinIO deployment.
For automatic synchronization of all buckets in a deployment to a remote site, use :ref:`site replication <minio-site-replication-overview>`.
The :mc:`mc admin cluster bucket` command has the following subcommands:
.. list-table::
:header-rows: 1
:widths: 40 60
* - Subcommand
- Description
* - :mc:`~mc admin cluster bucket import`
- .. include:: /reference/minio-mc-admin/mc-admin-cluster-bucket-import.rst
:start-after: start-mc-admin-cluster-bucket-import-desc
:end-before: end-mc-admin-cluster-bucket-import-desc
* - :mc:`~mc admin cluster bucket export`
- .. include:: /reference/minio-mc-admin/mc-admin-cluster-bucket-export.rst
:start-after: start-mc-admin-cluster-bucket-export-desc
:end-before: end-mc-admin-cluster-bucket-export-desc
.. toctree::
:titlesonly:
:hidden:
/reference/minio-mc-admin/mc-admin-cluster-bucket-import
/reference/minio-mc-admin/mc-admin-cluster-bucket-export

View File

@ -0,0 +1,64 @@
.. _minio-mc-admin-cluster-iam-export:
===============================
``mc admin cluster iam export``
===============================
.. default-domain:: minio
.. mc:: mc admin cluster iam export
Description
-----------
.. versionadded:: RELEASE.2022-06-26T18-51-48Z
.. start-mc-admin-cluster-iam-export-desc
The :mc:`mc admin cluster iam export` command exports :ref:`IAM <minio-authentication-and-identity-management>` metadata for use with the :mc:`mc admin cluster iam import` command.
.. end-mc-admin-cluster-iam-export-desc
The command saves the output as ``ALIAS-iam-metadata.zip``, where ``ALIAS`` is the :mc:`alias <mc admin cluster iam export ALIAS>` of the MinIO deployment.
.. tab-set::
.. tab-item:: EXAMPLE
The following command exports all IAM metadata for the ``myminio`` deployment.
.. code-block:: shell
:class: copyable
mc admin cluster iam export myminio
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin cluster iam export ALIAS
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
:end-before: end-minio-syntax
Starting with :mc-release:`RELEASE.2023-05-04T18-10-16Z`, :mc:`mc admin cluster iam export` adds support for aliases ending with a trailing forward slash ``ALIAS/``.
Prior to this release, the command would fail when provided a trailing forward slash.
Parameters
~~~~~~~~~~
.. mc-cmd:: ALIAS
:required:
The :ref:`alias <alias>` of the MinIO deployment to export IAM metadata for.
Global Flags
~~~~~~~~~~~~
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-mc-globals
:end-before: end-minio-mc-globals

View File

@ -0,0 +1,73 @@
.. _minio-mc-admin-cluster-iam-import:
===============================
``mc admin cluster iam import``
===============================
.. default-domain:: minio
.. mc:: mc admin cluster iam import
Description
-----------
.. versionadded:: RELEASE.2022-06-17T02-52-50Z
.. start-mc-admin-cluster-iam-import-desc
The :mc:`mc admin cluster iam import` command imports :ref:`IAM <minio-authentication-and-identity-management>` metadata as created by the :mc:`mc admin cluster iam export` command.
.. end-mc-admin-cluster-iam-import-desc
You can use this command to manually restore IAM metadata settings for a MinIO deployment.
.. tab-set::
.. tab-item:: EXAMPLE
The following command imports the IAM metadata of the specified file onto the ``myminio`` deployment.
.. code-block:: shell
:class: copyable
mc admin cluster iam import myminio ~/minio-metadata-backup/myminio-cluster.zip
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin cluster iam import \
ALIAS \
IAM-METADATA.ZIP
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
:end-before: end-minio-syntax
Starting with :mc-release:`RELEASE.2023-05-04T18-10-16Z`, :mc:`mc admin cluster iam import` adds support for aliases ending with a trailing forward slash ``ALIAS/``.
Prior to this release, the command would fail when provided a trailing forward slash.
Parameters
~~~~~~~~~~
.. mc-cmd:: ALIAS
:required:
The :mc-cmd:`alias <mc alias>` of the MinIO deployment.
.. mc-cmd:: IAM-METADATA.ZIP
:required:
The path to the IAM metadata file to import.
Use the :mc:`mc admin cluster iam export` to export IAM metadata for use with this command.
Global Flags
~~~~~~~~~~~~
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-mc-globals
:end-before: end-minio-mc-globals

View File

@ -0,0 +1,56 @@
.. _minio-mc-admin-cluster-iam:
========================
``mc admin cluster iam``
========================
.. default-domain:: minio
.. contents:: Table of Contents
:local:
:depth: 2
.. mc:: mc admin cluster iam
Description
-----------
.. versionadded:: RELEASE.2022-06-26T18-51-48Z
.. start-mc-admin-cluster-iam-desc
The :mc:`mc admin cluster iam` command and its subcommands provide tools for manually importing and exporting MinIO :ref:`identity and access management (IAM) <minio-authentication-and-identity-management>` metadata.
.. end-mc-admin-cluster-iam-desc
For automatic synchronization of all IAM configurations in a deployment to a remote site, use :ref:`site replication <minio-site-replication-overview>`.
The :mc:`mc admin cluster iam` command has the following subcommands:
.. list-table::
:header-rows: 1
:widths: 40 60
* - Subcommand
- Description
* - :mc:`~mc admin cluster iam import`
- .. include:: /reference/minio-mc-admin/mc-admin-cluster-iam-import.rst
:start-after: start-mc-admin-cluster-iam-import-desc
:end-before: end-mc-admin-cluster-iam-import-desc
* - :mc:`~mc admin cluster iam export`
- .. include:: /reference/minio-mc-admin/mc-admin-cluster-iam-export.rst
:start-after: start-mc-admin-cluster-iam-export-desc
:end-before: end-mc-admin-cluster-iam-export-desc
.. toctree::
:titlesonly:
:hidden:
/reference/minio-mc-admin/mc-admin-cluster-iam-import
/reference/minio-mc-admin/mc-admin-cluster-iam-export

View File

@ -92,15 +92,15 @@ Use :mc-cmd:`mc admin group add` to create a new group to an S3-compatible host:
List Available Groups
~~~~~~~~~~~~~~~~~~~~~
Use :mc-cmd:`mc admin group list` to list list all groups on an S3-compatible
Use :mc-cmd:`mc admin group ls` to list list all groups on an S3-compatible
host:
.. code-block:: shell
:class: copyable
mc admin group list ALIAS
mc admin group ls ALIAS
- Replace :mc-cmd:`ALIAS <mc admin group list TARGET>` with the
- Replace :mc-cmd:`ALIAS <mc admin group ls TARGET>` with the
:mc-cmd:`alias <mc alias>` of the S3-compatible host.
@ -124,18 +124,18 @@ S3-compatible host:
Remove a Group
~~~~~~~~~~~~~~
Use :mc-cmd:`mc admin group remove` to remove a group from an S3-compatible
Use :mc-cmd:`mc admin group rm` to remove a group from an S3-compatible
host:
.. code-block:: shell
:class: copyable
mc admin group remove ALIAS GROUPNAME
mc admin group rm ALIAS GROUPNAME
- Replace :mc-cmd:`ALIAS <mc admin group remove TARGET>` with the
- Replace :mc-cmd:`ALIAS <mc admin group rm TARGET>` with the
:mc-cmd:`alias <mc alias>` of the S3-compatible host.
- Replace :mc-cmd:`GROUPNAME <mc admin group remove GROUPNAME>` with the
- Replace :mc-cmd:`GROUPNAME <mc admin group rm GROUPNAME>` with the
name of the group.
Disable a Group
@ -183,10 +183,10 @@ Quick Reference
:mc-cmd:`mc admin group info TARGET GROUPNAME <mc admin group info>`
Returns detailed information for a group on the MinIO deployment.
:mc-cmd:`mc admin group list TARGET <mc admin group list>`
:mc-cmd:`mc admin group ls TARGET <mc admin group ls>`
Returns a list of all groups on the MinIO deployment.
:mc-cmd:`mc admin group remove TARGET GROUPNAME <mc admin group remove>`
:mc-cmd:`mc admin group rm TARGET GROUPNAME <mc admin group rm>`
Removes a group on the MinIO deployment.
:mc-cmd:`mc admin group enable TARGET GROUPNAME <mc admin group enable>`
@ -221,7 +221,7 @@ Syntax
.. mc-cmd:: GROUPNAME
The name of the group. The command creates the group if it does not
already exist. Use :mc-cmd:`mc admin group list` to review the existing
already exist. Use :mc-cmd:`mc admin group ls` to review the existing
groups on a deployment.
.. mc-cmd:: MEMBERS
@ -229,7 +229,7 @@ Syntax
The name of the user to add to the group.
The user *must* exist on the :mc-cmd:`~mc admin group add TARGET` MinIO
deployment. Use :mc-cmd:`mc admin user list` to review the available
deployment. Use :mc-cmd:`mc admin user ls` to review the available
users on the deployment.
.. mc-cmd:: info
@ -256,7 +256,7 @@ Syntax
The name of the group.
.. mc-cmd:: list
.. mc-cmd:: ls, list
:fullpath:
List all groups on the target MinIO deployment. The command has the
@ -265,7 +265,7 @@ Syntax
.. code-block:: shell
:class: copyable
mc admin group list TARGET
mc admin group ls TARGET
The command accepts the following arguments:
@ -274,19 +274,19 @@ Syntax
The :mc-cmd:`alias <mc alias>` of a configured MinIO deployment from
which to retrieve groups.
.. mc-cmd:: remove
.. mc-cmd:: rm, remove
:fullpath:
Removes a group on the target MinIO deployment. Removing a group does *not*
remove any users with membership in the group. Use
:mc-cmd:`mc admin user remove` to remove users from a group.
:mc-cmd:`mc admin user rm` to remove users from a group.
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc admin group remove TARGET GROUPNAME
mc admin group rm TARGET GROUPNAME
The command accepts the following arguments:

View File

@ -43,7 +43,10 @@ The :mc-cmd:`mc admin idp ldap` command has the following subcommands:
* - :mc-cmd:`mc admin idp ldap update`
- Modify an existing AD/LDAP IDP server configuration.
* - :mc-cmd:`mc admin idp ldap remove`
* - :mc-cmd:`mc admin idp ldap ls`
- Lists AD/LDAP server configurations.
* - :mc-cmd:`mc admin idp ldap rm`
- Remove an AD/LDAP IDP server configuration from a deployment.
* - :mc-cmd:`mc admin idp ldap info`
@ -141,7 +144,33 @@ Syntax
- Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment to update for AD/LDAP integration.
- Replace the ``[CFG_PARAM#]`` with each of the :ref:`configuration setting <minio-ldap-config-settings>` key-value pairs to update in the format of ``PARAMETER="value"``.
.. mc-cmd:: remove
.. mc-cmd:: ls, list
Lists the existing set of configurations for an AD/LDAP provider.
.. tab-set::
.. tab-item:: EXAMPLE
The following example lists the AD/LDAP configuration settings for the ``myminio`` deployment.
.. code-block:: shell
:class: copyable
mc admin idp ldap ls myminio
.. tab-item:: SYNTAX
The command has the following syntax:
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin idp ldap ls ALIAS
- Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment to list the AD/LDAP integration.
.. mc-cmd:: rm, remove
Remove the existing configuration for an AD/LDAP provider.
@ -154,7 +183,7 @@ Syntax
.. code-block:: shell
:class: copyable
mc admin idp ldap remove myminio
mc admin idp ldap rm myminio
.. tab-item:: SYNTAX
@ -163,7 +192,7 @@ Syntax
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin idp ldap remove \
mc [GLOBALFLAGS] admin idp ldap rm \
ALIAS
- Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment to remove the AD/LDAP integration.

View File

@ -146,7 +146,7 @@ Syntax
If not specified, the command updates the default configuration.
- Replace the ``[CFG_PARAM#]`` with each of the :ref:`configuration setting <minio-open-id-config-settings>` key-value pairs to update in the format of ``PARAMETER="value"``.
.. mc-cmd:: remove
.. mc-cmd:: rm, remove
Remove an existing set of configurations for an OpenID provider.
@ -159,7 +159,7 @@ Syntax
.. code-block:: shell
:class: copyable
mc admin idp openid remove myminio test_config
mc admin idp openid rm myminio test_config
.. tab-item:: SYNTAX
@ -168,7 +168,7 @@ Syntax
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin idp openid remove \
mc [GLOBALFLAGS] admin idp openid rm \
ALIAS \
[CFG_NAME]
@ -176,7 +176,7 @@ Syntax
- Replace ``CFG_NAME`` with a unique string for this configuration.
If not specified, the command removes the default configurations.
.. mc-cmd:: list
.. mc-cmd:: ls, list
Outputs a list of existing configuration sets for OpenID providers.
@ -189,7 +189,7 @@ Syntax
.. code-block:: shell
:class: copyable
mc admin idp openid list myminio
mc admin idp openid ls myminio
.. tab-item:: SYNTAX
@ -198,7 +198,7 @@ Syntax
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin idp openid list ALIAS
mc [GLOBALFLAGS] admin idp openid ls ALIAS
- Replace ``ALIAS`` with the :ref:`alias <alias>` of a MinIO deployment to list OpenID integrations for.

View File

@ -1,6 +1,6 @@
========================
``mc admin policy list``
========================
======================
``mc admin policy ls``
======================
.. default-domain:: minio
@ -8,6 +8,7 @@
:local:
:depth: 2
.. mc:: mc admin policy ls
.. mc:: mc admin policy list
Syntax
@ -19,6 +20,7 @@ Lists all policies on the target MinIO deployment.
.. end-mc-admin-policy-list-desc
The :mc:`mc admin policy list` command has equivalent functionality to :mc:`mc admin policy ls`.
.. tab-set::
@ -29,7 +31,7 @@ Lists all policies on the target MinIO deployment.
.. code-block:: shell
:class: copyable
mc admin policy list play
mc admin policy ls play
.. tab-item:: SYNTAX
@ -38,7 +40,7 @@ Lists all policies on the target MinIO deployment.
.. code-block:: shell
:class: copyable
mc admin policy list TARGET
mc admin policy ls TARGET
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
@ -48,7 +50,7 @@ Lists all policies on the target MinIO deployment.
Parameters
~~~~~~~~~~
The :mc-cmd:`mc admin policy list` command accepts the following arguments:
The :mc-cmd:`mc admin policy ls` command accepts the following arguments:
.. mc-cmd:: TARGET
@ -69,7 +71,7 @@ List the policies that exist on the deployment at alias ``myminio``.
.. code-block:: shell
:class: copyable
mc admin policy list myminio
mc admin policy ls myminio
Output
~~~~~~

View File

@ -1,6 +1,6 @@
==========================
``mc admin policy remove``
==========================
======================
``mc admin policy rm``
======================
.. default-domain:: minio
@ -9,6 +9,7 @@
:depth: 2
.. mc:: mc admin policy remove
.. mc:: mc admin policy rm
Syntax
------
@ -19,6 +20,7 @@ Removes an IAM policy from the target MinIO deployment.
.. end-mc-admin-policy-remove-desc
The :mc:`mc admin policy remove` command has equivalent functionality to :mc:`mc admin policy rm`.
.. tab-set::
@ -29,7 +31,7 @@ Removes an IAM policy from the target MinIO deployment.
.. code-block:: shell
:class: copyable
mc admin policy remove myminio writeonly
mc admin policy rm myminio writeonly
.. tab-item:: SYNTAX
@ -38,7 +40,7 @@ Removes an IAM policy from the target MinIO deployment.
.. code-block:: shell
:class: copyable
mc admin policy remove TARGET POLICYNAME
mc admin policy rm TARGET POLICYNAME
.. include:: /includes/common-minio-mc.rst
:start-after: start-minio-syntax
@ -48,7 +50,7 @@ Removes an IAM policy from the target MinIO deployment.
Parameters
~~~~~~~~~~
The :mc-cmd:`mc admin policy create` command accepts the following arguments:
The :mc-cmd:`mc admin policy rm` command accepts the following arguments:
.. mc-cmd:: TARGET
@ -73,4 +75,4 @@ Remove a policy called ``listbuckets``.
.. code-block:: shell
:class: copyable
mc admin policy remove myminio listbuckets
mc admin policy rm myminio listbuckets

View File

@ -73,12 +73,12 @@ Subcommands
:start-after: start-mc-admin-policy-info-desc
:end-before: end-mc-admin-policy-info-desc
* - :mc:`~mc admin policy list`
* - :mc:`~mc admin policy ls`
- .. include:: /reference/minio-mc-admin/mc-admin-policy-list.rst
:start-after: start-mc-admin-policy-list-desc
:end-before: end-mc-admin-policy-list-desc
* - :mc:`~mc admin policy remove`
* - :mc:`~mc admin policy rm`
- .. include:: /reference/minio-mc-admin/mc-admin-policy-remove.rst
:start-after: start-mc-admin-policy-remove-desc
:end-before: end-mc-admin-policy-remove-desc

View File

@ -186,7 +186,7 @@ Syntax
Available values are ``enable`` and ``disable``.
If not defined, MInIO uses asynchronous site replication.
.. mc-cmd:: rm
.. mc-cmd:: rm, remove
:fullpath:
.. versionchanged:: RELEASE.2023-01-11T03-14-16Z

View File

@ -1,8 +1,8 @@
.. _minio-mc-admin-user-list:
======================
``mc admin user list``
======================
====================
``mc admin user ls``
====================
.. default-domain:: minio
@ -11,6 +11,7 @@
:depth: 2
.. mc:: mc admin user list
.. mc:: mc admin user ls
Syntax
@ -18,11 +19,13 @@ Syntax
.. start-mc-admin-user-list-desc
The :mc:`mc admin user list` command lists all :ref:`MinIO users <minio-internal-idp>` on the target MinIO deployment.
The :mc:`mc admin user ls` command lists all :ref:`MinIO users <minio-internal-idp>` on the target MinIO deployment.
.. end-mc-admin-user-list-desc
:mc-cmd:`mc admin user list` does *not* return the access key or secret key associated to a user.
The :mc:`mc admin user list` command has equivalent functionality to :mc:`mc admin user ls`.
:mc-cmd:`mc admin user ls` does *not* return the access key or secret key associated to a user.
Use :mc-cmd:`mc admin user info` to retrieve detailed user information, including the user access key.
To manage external Identity Provider users, see :mc:`OIDC <mc admin idp openid>` or :mc:`AD/LDAP <mc admin idp ldap>`.
@ -36,7 +39,7 @@ To manage external Identity Provider users, see :mc:`OIDC <mc admin idp openid>`
.. code-block:: shell
:class: copyable
mc admin user list myminio
mc admin user ls myminio
.. tab-item:: SYNTAX
@ -76,14 +79,14 @@ Example
List Available Users
~~~~~~~~~~~~~~~~~~~~
Use :mc-cmd:`mc admin user list` to list all users on a MinIO deployment:
Use :mc-cmd:`mc admin user ls` to list all users on a MinIO deployment:
.. code-block:: shell
:class: copyable
mc admin user list ALIAS
mc admin user ls ALIAS
- Replace :mc-cmd:`ALIAS <mc admin user list ALIAS>` with the :mc-cmd:`alias <mc alias>` of the MinIO deployment.
- Replace :mc-cmd:`ALIAS <mc admin user ls ALIAS>` with the :mc-cmd:`alias <mc alias>` of the MinIO deployment.
The output resembles the following:

View File

@ -1,8 +1,8 @@
.. _minio-mc-admin-user-remove:
========================
``mc admin user remove``
========================
=====================
``mc admin user rm``
=====================
.. default-domain:: minio
@ -11,16 +11,19 @@
:depth: 2
.. mc:: mc admin user remove
.. mc:: mc admin user rm
Syntax
------
.. start-mc-admin-user-remove-desc
The :mc:`mc admin user remove` command removes a :ref:`MinIO user <minio-internal-idp>` on the target MinIO deployment.
The :mc:`mc admin user rm` command removes a :ref:`MinIO user <minio-internal-idp>` on the target MinIO deployment.
.. end-mc-admin-user-remove-desc
The :mc:`mc admin user remove` command has equivalent functionality to :mc:`mc admin user rm`.
To manage external Identity Provider users, see :mc:`OIDC <mc admin idp openid>` or :mc:`AD/LDAP <mc admin idp ldap>`.
.. tab-set::
@ -32,7 +35,7 @@ To manage external Identity Provider users, see :mc:`OIDC <mc admin idp openid>`
.. code-block:: shell
:class: copyable
mc admin user remove myminio myuser
mc admin user rm myminio myuser
.. tab-item:: SYNTAX
@ -78,16 +81,16 @@ Example
Remove a User
~~~~~~~~~~~~~
Use :mc-cmd:`mc admin user remove` to remove a user from a MinIO deployment:
Use :mc-cmd:`mc admin user rm` to remove a user from a MinIO deployment:
.. code-block:: shell
:class: copyable
mc admin user remove ALIAS USERNAME
mc admin user rm ALIAS USERNAME
- Replace :mc-cmd:`ALIAS <mc admin user remove ALIAS>` with the :mc-cmd:`alias <mc alias>` of the MinIO deployment.
- Replace :mc-cmd:`ALIAS <mc admin user rm ALIAS>` with the :mc-cmd:`alias <mc alias>` of the MinIO deployment.
- Replace :mc-cmd:`USERNAME <mc admin user remove USERNAME>` with the username of the user to remove.
- Replace :mc-cmd:`USERNAME <mc admin user rm USERNAME>` with the username of the user to remove.
Behavior
--------

View File

@ -1,8 +1,8 @@
.. _minio-mc-admin-svcacct-list:
==============================
``mc admin user svcacct list``
==============================
============================
``mc admin user svcacct ls``
============================
.. default-domain:: minio
@ -11,6 +11,7 @@
:depth: 2
.. mc:: mc admin user svcacct list
.. mc:: mc admin user svcacct ls
Syntax
@ -18,10 +19,12 @@ Syntax
.. start-mc-admin-svcacct-list-desc
The :mc-cmd:`mc admin user svcacct list` command lists all access keys associated to the specified user.
The :mc:`mc admin user svcacct ls` command lists all access keys associated to the specified user.
.. end-mc-admin-svcacct-list-desc
The alias :mc:`mc admin user svcacct list` has equivalent functionality to :mc:`mc admin user svcacct ls`.
.. tab-set::
.. tab-item:: EXAMPLE
@ -31,7 +34,7 @@ The :mc-cmd:`mc admin user svcacct list` command lists all access keys associate
.. code-block:: shell
:class: copyable
mc admin user svcacct list myminio admin1
mc admin user svcacct ls myminio admin1
.. tab-item:: SYNTAX
@ -40,7 +43,7 @@ The :mc-cmd:`mc admin user svcacct list` command lists all access keys associate
.. code-block:: shell
:class: copyable
mc [GLOBALFLAGS] admin user svcacct list \
mc [GLOBALFLAGS] admin user svcacct ls \
ALIAS \
USER

View File

@ -1,8 +1,8 @@
.. _minio-mc-admin-svcacct-remove:
================================
``mc admin user svcacct remove``
================================
============================
``mc admin user svcacct rm``
============================
.. default-domain:: minio
@ -11,6 +11,7 @@
:depth: 2
.. mc:: mc admin user svcacct remove
.. mc:: mc admin user svcacct rm
Syntax
@ -18,9 +19,11 @@ Syntax
.. start-mc-admin-svcacct-remove-desc
The :mc-cmd:`mc admin user svcacct remove` command removes an access key associated to a user on the deployment.
The :mc:`mc admin user svcacct rm` command removes an access key associated to a user on the deployment.
.. end-mc-admin-svcacct-remove-desc
The :mc:`mc admin user svcacct remove` command has equivalent functionality to :mc:`mc admin user svcacct rm`.
Applications can no longer authenticate using that access key after removal.
@ -33,7 +36,7 @@ Applications can no longer authenticate using that access key after removal.
.. code-block:: shell
:class: copyable
mc admin user svcacct remove myminio myuserserviceaccount
mc admin user svcacct rm myminio myuserserviceaccount
.. tab-item:: SYNTAX

View File

@ -67,7 +67,7 @@ The :mc:`mc admin user svcacct` command has the following subcommands:
:start-after: start-mc-admin-svcacct-list-desc
:end-before: end-mc-admin-svcacct-list-desc
* - :mc:`~mc admin user svcacct remove`
* - :mc:`~mc admin user svcacct rm`
- .. include:: /reference/minio-mc-admin/mc-admin-user-svcacct-remove.rst
:start-after: start-mc-admin-svcacct-remove-desc
:end-before: end-mc-admin-svcacct-remove-desc

View File

@ -69,12 +69,12 @@ Subcommands
:start-after: start-mc-admin-user-info-desc
:end-before: end-mc-admin-user-info-desc
* - :mc:`~mc admin user list`
* - :mc:`~mc admin user ls`
- .. include:: /reference/minio-mc-admin/mc-admin-user-list.rst
:start-after: start-mc-admin-user-list-desc
:end-before: end-mc-admin-user-list-desc
* - :mc:`~mc admin user remove`
* - :mc:`~mc admin user rm`
- .. include:: /reference/minio-mc-admin/mc-admin-user-remove.rst
:start-after: start-mc-admin-user-remove-desc
:end-before: end-mc-admin-user-remove-desc

View File

@ -217,8 +217,8 @@ The following table lists :mc-cmd:`mc` commands:
:end-before: end-mc-encrypt-desc
* - | :mc:`mc event add`
| :mc:`mc event list`
| :mc:`mc event remove`
| :mc:`mc event ls`
| :mc:`mc event rm`
- .. include:: /reference/minio-mc/mc-event.rst
:start-after: start-mc-event-desc
:end-before: end-mc-event-desc
@ -337,7 +337,7 @@ The following table lists :mc-cmd:`mc` commands:
:end-before: end-mc-rm-desc
* - | :mc:`mc share download`
| :mc:`mc share list`
| :mc:`mc share ls`
| :mc:`mc share upload`
- .. include:: /reference/minio-mc/mc-share.rst
:start-after: start-mc-share-desc

View File

@ -1,8 +1,8 @@
.. _minio-mc-event-list:
=================
``mc event list``
=================
===============
``mc event ls``
===============
.. default-domain:: minio
@ -11,17 +11,20 @@
:depth: 2
.. mc:: mc event list
.. mc:: mc event ls
Syntax
------
.. start-mc-event-list-desc
The :mc:`mc event list` command lists all event notification triggers for a
The :mc:`mc event ls` command lists all event notification triggers for a
bucket.
.. end-mc-event-list-desc
The alias :mc:`mc event list` has equivalent functionality to :mc:`mc event ls`.
.. tab-set::
.. tab-item:: EXAMPLE
@ -33,7 +36,7 @@ bucket.
.. code-block:: shell
:class: copyable
mc event list myminio myminio/mydata arn:aws:sqs::primary:target
mc event ls myminio myminio/mydata arn:aws:sqs::primary:target
.. tab-item:: SYNTAX
@ -100,14 +103,14 @@ List Event Notifications on a Bucket
.. code-block:: shell
:class: copyable
mc event list myminio/mydata
mc event ls myminio/mydata
.. tab-item:: Syntax
.. code-block:: shell
:class: copyable
mc event list ALIAS ARN
mc event ls ALIAS ARN
- Replace ``ALIAS`` with the :ref:`alias <alias>` of the MinIO
deployment on which to add the bucket notification event. For example:

View File

@ -1,8 +1,8 @@
.. _minio-mc-event-remove:
===================
``mc event remove``
===================
===============
``mc event rm``
===============
.. default-domain:: minio
@ -11,17 +11,20 @@
:depth: 2
.. mc:: mc event remove
.. mc:: mc event rm
Syntax
------
.. start-mc-event-remove-desc
The :mc:`mc event remove` command removes event notification triggers on a
The :mc:`mc event rm` command removes event notification triggers on a
bucket.
.. end-mc-event-remove-desc
The :mc:`mc event remove` command has equivalent functionality to :mc:`mc event rm`.
.. tab-set::
.. tab-item:: EXAMPLE
@ -33,7 +36,7 @@ bucket.
.. code-block:: shell
:class: copyable
mc event remove myminio/mydata arn:aws:sqs::primary:target
mc event rm myminio/mydata arn:aws:sqs::primary:target
.. tab-item:: SYNTAX
@ -87,14 +90,14 @@ Parameters
*Optional* The event(s) to remove. Specify multiple events using a comma
``,`` delimiter. See :ref:`mc-event-supported-events` for supported events.
Defaults to removing all events on the :mc-cmd:`~mc event remove ALIAS`
bucket with the :mc-cmd:`~mc event remove ARN` notification target.
Defaults to removing all events on the :mc-cmd:`~mc event rm ALIAS`
bucket with the :mc-cmd:`~mc event rm ARN` notification target.
.. mc-cmd:: --force
*Optional* Removes all events on the :mc-cmd:`~mc event remove ALIAS` bucket
with the :mc-cmd:`~mc event remove ARN` notification target.
*Optional* Removes all events on the :mc-cmd:`~mc event rm ALIAS` bucket
with the :mc-cmd:`~mc event rm ARN` notification target.
.. mc-cmd:: --prefix
@ -102,8 +105,8 @@ Parameters
*Optional* The bucket prefix in which the command removes bucket
notifications.
For example, given a :mc-cmd:`~mc event remove ALIAS` of
``play/mybucket`` and a :mc-cmd:`~mc event remove --prefix` of
For example, given a :mc-cmd:`~mc event rm ALIAS` of
``play/mybucket`` and a :mc-cmd:`~mc event rm --prefix` of
``photos``, the command only removes bucket notifications in
``play/mybucket/photos``.
@ -113,8 +116,8 @@ Parameters
*Optional* The bucket suffix in which the command removes bucket
notifications.
For example, given a :mc-cmd:`~mc event remove ALIAS` of
``play/mybucket`` and a :mc-cmd:`~mc event remove --suffix` of
For example, given a :mc-cmd:`~mc event rm ALIAS` of
``play/mybucket`` and a :mc-cmd:`~mc event rm --suffix` of
``.jpg``, the command only removes bucket notifications in
``play/mybucket/*.jpg``.
@ -142,14 +145,14 @@ Remove Event Notifications from a Bucket
.. code-block:: shell
:class: copyable
mc event remove myminio/mydata arn:minio:sqs::primary:webhook
mc event rm myminio/mydata arn:minio:sqs::primary:webhook
.. tab-item:: Syntax
.. code-block:: shell
:class: copyable
mc event remove ALIAS ARN
mc event rm ALIAS ARN
- Replace ``ALIAS`` with the :ref:`alias <alias>` of the MinIO
deployment on which to add the bucket notification event. For example:

View File

@ -43,12 +43,12 @@ Subcommands
:start-after: start-mc-event-add-desc
:end-before: end-mc-event-add-desc
* - :mc:`~mc event list`
* - :mc:`~mc event ls`
- .. include:: /reference/minio-mc/mc-event-list.rst
:start-after: start-mc-event-list-desc
:end-before: end-mc-event-list-desc
* - :mc:`~mc event remove`
* - :mc:`~mc event rm`
- .. include:: /reference/minio-mc/mc-event-remove.rst
:start-after: start-mc-event-remove-desc
:end-before: end-mc-event-remove-desc

View File

@ -10,6 +10,7 @@
:local:
:depth: 2
.. mc:: mc ilm rule list
.. mc:: mc ilm rule ls
.. versionchanged:: RELEASE.2022-12-24T15-21-38Z
@ -25,6 +26,8 @@ The :mc:`mc ilm rule ls` command summarizes all configured object lifecycle mana
.. end-mc-ilm-rule-ls-desc
The :mc:`mc ilm rule list` command has equivalent functionality to :mc:`mc ilm rule ls`.
.. tab-set::
.. tab-item:: EXAMPLE

View File

@ -10,6 +10,7 @@
:local:
:depth: 2
.. mc:: mc ilm tier list
.. mc:: mc ilm tier ls
.. versionchanged:: RELEASE.2022-12-24T15-21-38Z
@ -25,6 +26,8 @@ The :mc:`mc ilm tier ls` command shows the remote tiers configured on a deployme
.. end-mc-ilm-tier-ls-desc
The :mc:`mc ilm tier list` command has equivalent functionality to :mc:`mc ilm tier ls`.
Syntax
------

View File

@ -10,6 +10,7 @@
:local:
:depth: 2
.. mc:: mc ilm tier remove
.. mc:: mc ilm tier rm
Description
@ -21,6 +22,8 @@ The :mc:`mc ilm tier rm` command removes an remote tier that has not been used t
.. end-mc-ilm-tier-rm-desc
The :mc:`mc ilm tier remove` command has equivalent functionality to :mc:`mc ilm tier rm`
.. note::
Once a tier has transitioned objects, it cannot be removed.

View File

@ -153,7 +153,7 @@ Parameters
:start-after: start-mc-limit-flags-desc
:end-before: end-mc-limit-flags-desc
.. mc-cmd:: md5
.. mc-cmd:: --md5
Forces all uploads to calculate MD5 checksums.
@ -223,6 +223,12 @@ Parameters
``mc mirror --remove`` does not verify that the contents of object C are the same on both Source and Target, only that an object called `C` exists on both.
To ensure objects on the Source and Target match both names `and` content, use :mc-cmd:`~mc mirror --overwrite` or :mc-cmd:`~mc mirror --watch`.
.. versionchanged:: RELEASE.2023-05-04T18-10-16Z
``mc mirror --remove`` returns an error if the target path is a local filesystem directory that does not exist.
In prior versions, specifying ``/path/to/directory`` would result in the removal of the ``/path/to`` folder if ``directory`` did not exist.
.. mc-cmd:: storage-class, sc

View File

@ -10,6 +10,7 @@
:local:
:depth: 2
.. mc:: mc replicate list
.. mc:: mc replicate ls
.. versionchanged:: RELEASE.2022-12-24T15-21-38Z
@ -27,6 +28,8 @@ MinIO bucket.
.. end-mc-replicate-ls-desc
The :mc:`mc replicate list` command has equivalent functionality to :mc:`mc replicate ls`.
.. tab-set::
.. tab-item:: EXAMPLE

View File

@ -10,6 +10,7 @@
:local:
:depth: 2
.. mc:: mc replicate remove
.. mc:: mc replicate rm
.. versionchanged:: RELEASE.2022-12-24T15-21-38Z
@ -28,6 +29,8 @@ MinIO bucket.
.. end-mc-replicate-rm-desc
The :mc:`mc replicate remove` command has equivalent functionality to :mc:`mc replicate rm`.
.. code-block:: shell
mc [GLOBALFLAGS] replicate rm FLAGS [FLAGS] ALIAS

View File

@ -1,5 +1,5 @@
===================
``mc share list``
``mc share ls``
===================
.. default-domain:: minio
@ -9,17 +9,20 @@
:depth: 2
.. mc:: mc share list
.. mc:: mc share ls
Syntax
-----------
.. start-mc-share-list-desc
The :mc:`mc share list` command displays any unexpired presigned URLs generated
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
@ -37,8 +40,8 @@ documentation on :aws-docs:`Pre-Signed URLs
.. code-block:: shell
:class: copyable
mc share list upload myminio/mydata
mc share list download myminio/mydata
mc share ls upload myminio/mydata
mc share ls download myminio/mydata
.. tab-item:: SYNTAX
@ -62,13 +65,13 @@ Parameters
*Required* Lists all unexpired presigned download (``GET``) URLs.
Mutually exclusive with :mc:`mc share list upload`
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 list download`
Mutually exclusive with :mc:`mc share ls download`
.. mc-cmd:: ALIAS
@ -94,28 +97,28 @@ List Generated Download and Upload URLs
.. tab-item:: List Active Download Presigned URLs
Use :mc:`mc share list download` to generate a URL
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 list download ALIAS
mc share ls download ALIAS
- Replace :mc-cmd:`ALIAS <mc share list ALIAS>` with the
- 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 list upload` to generate a URL that
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 list upload ALIAS
mc share ls upload ALIAS
- Replace :mc-cmd:`ALIAS <mc share upload ALIAS>` with the
:ref:`alias <alias>` of the MinIO deployment.

View File

@ -72,6 +72,13 @@ Parameters
mc tag list myminio/mybucket/object.txt
.. mc-cmd:: --recursive, r
:optional:
.. versionadded:: RELEASE.2023-05-04T18-10-16Z
Recursively lists the tags for all objects at the path specified to :mc:`ALIAS <mc tag list ALIAS>`.
.. mc-cmd:: --rewind
:optional:

View File

@ -30,7 +30,7 @@ The :mc:`mc tag remove` command removes all tags from a bucket or object.
.. tab-set::
.. tab-item:: EXAMPLE
The following command removes tags for the ``mydata`` bucket on the
``myminio`` MinIO deployment:
@ -71,6 +71,13 @@ Parameters
mc tag remove myminio/mybucket/object.txt
.. mc-cmd:: --recursive, r
:optional:
.. versionadded:: RELEASE.2023-05-04T18-10-16Z
Recursively removes all tags from all objects at the specified :mc:`ALIAS <mc tag remove ALIAS>`.
.. mc-cmd:: --rewind
:optional:

View File

@ -86,6 +86,13 @@ Parameters
mc tag set myminio/mybucket/object.txt "key1=value1&key2=value2"
.. mc-cmd:: --recursive, r
:optional:
.. versionadded:: RELEASE.2023-05-04T18-10-16Z
Recursively applies the tag to all objects at the path specified to :mc:`ALIAS <mc tag set ALIAS>`.
.. mc-cmd:: --rewind
:optional: