mirror of
https://github.com/minio/docs.git
synced 2025-07-31 18:04:52 +03:00
165 lines
4.2 KiB
ReStructuredText
165 lines
4.2 KiB
ReStructuredText
=========
|
|
``mc mb``
|
|
=========
|
|
|
|
.. default-domain:: minio
|
|
|
|
.. contents:: Table of Contents
|
|
:local:
|
|
:depth: 2
|
|
|
|
.. mc:: mc mb
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. start-mc-mb-desc
|
|
|
|
The :mc:`mc mb` command creates a new bucket or directory at the
|
|
specified path.
|
|
|
|
.. end-mc-mb-desc
|
|
|
|
You can also use :mc:`mc mb` against the local filesystem to produce
|
|
similar results to the ``mkdir -p`` commandline tool.
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: EXAMPLE
|
|
|
|
The following command creates a new bucket ``mydata`` on the
|
|
``myminio`` MinIO deployment. The command creates the bucket
|
|
with :ref:`object locking enabled <minio-object-locking>`.
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc mb --with-locks myminio/mydata
|
|
|
|
.. tab-item:: SYNTAX
|
|
|
|
The command has the following syntax:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc [GLOBALFLAGS] mb \
|
|
[--ignore-existing] \
|
|
[--region "string"] \
|
|
[--with-lock] \
|
|
ALIAS
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-syntax
|
|
:end-before: end-minio-syntax
|
|
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
.. mc-cmd:: ALIAS
|
|
|
|
*Required* The MinIO or other S3-compatible service on which to create the
|
|
new bucket.
|
|
|
|
For creating a bucket on MinIO, specify the
|
|
:ref:`alias <alias>` and the name of the bucket. For example:
|
|
|
|
.. code-block:: none
|
|
|
|
mc mb play/mybucket
|
|
|
|
For creating a directory on a local filesystem, specify the full
|
|
path to that directory. For example:
|
|
|
|
.. code-block:: none
|
|
|
|
mc mb ~/mydata/mydir
|
|
|
|
.. mc-cmd:: --ignore-existing, p
|
|
|
|
|
|
Directs :mc-cmd:`mc mb` to do nothing if the bucket or directory already
|
|
exists.
|
|
|
|
.. mc-cmd:: --region
|
|
|
|
|
|
The region in which to create the specified bucket. Has no effect if the
|
|
specified :mc-cmd:`~mc mb ALIAS` is a filesystem directory.
|
|
|
|
.. mc-cmd:: --with-lock, l
|
|
|
|
|
|
Enables :ref:`object locking <minio-object-locking>` on the specified
|
|
bucket. Has no effect if the specified ``ALIAS`` is a
|
|
:ref:`standalone <minio-installation-comparison>` MinIO deployments *or*
|
|
a filesystem directory.
|
|
|
|
.. important::
|
|
|
|
You can *only* enable object locking when creating the bucket.
|
|
Buckets created without object locking cannot use
|
|
:ref:`Bucket Lifecycle Management <minio-lifecycle-management>` or
|
|
:ref:`Bucket Object Locking <minio-object-locking>` functionality.
|
|
|
|
Global Flags
|
|
~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-globals
|
|
:end-before: end-minio-mc-globals
|
|
|
|
Examples
|
|
--------
|
|
|
|
Create Bucket
|
|
~~~~~~~~~~~~~
|
|
|
|
Use :mc:`mc mb` to create a bucket on an S3-compatible host. The
|
|
:mc-cmd:`~mc mb --with-lock` option creates the bucket with locking
|
|
enabled:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc mb --with-lock ALIAS/BUCKET
|
|
|
|
- Replace :mc-cmd:`ALIAS <mc mb ALIAS>` with the
|
|
:mc:`alias <mc alias>` of the S3-compatible host.
|
|
|
|
- Replace :mc-cmd:`BUCKET <mc mb ALIAS>` with the bucket to create.
|
|
|
|
Behavior
|
|
--------
|
|
|
|
Bucket Limits for Non-MinIO S3 Services
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Certain S3 services may restrict the number of buckets a given user or account
|
|
can create. For example, Amazon S3 limits each account to
|
|
:s3-docs:`100 buckets <BucketRestrictions.html>`. :mc:`mc mb` may return an
|
|
error if the user has reached bucket limits on the target S3 service.
|
|
|
|
MinIO Object Storage deployments do not place any limits on the number of
|
|
buckets each user can create.
|
|
|
|
Enable Object Locking at Bucket Creation
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
MinIO follows
|
|
:s3-docs:`AWS S3 behavior <object-lock-overview.html#object-lock-bucket-config>`
|
|
where you *must* enable :ref:`object locking <minio-object-locking>` at
|
|
bucket creation. Buckets created without object can *never* enable object
|
|
retention or locking.
|
|
|
|
Enabling bucket locking does *not* set any object locking or retention settings.
|
|
Consider enabling bucket locking as standard practice.
|
|
|
|
S3 Compatibility
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-s3-compatibility
|
|
:end-before: end-minio-mc-s3-compatibility
|