mirror of
https://github.com/minio/docs.git
synced 2025-04-25 17:22:39 +03:00
105 lines
2.3 KiB
ReStructuredText
105 lines
2.3 KiB
ReStructuredText
.. _minio-mc-replicate-import:
|
|
|
|
=======================
|
|
``mc replicate import``
|
|
=======================
|
|
|
|
.. default-domain:: minio
|
|
|
|
.. contents:: Table of Contents
|
|
:local:
|
|
:depth: 2
|
|
|
|
.. mc:: mc replicate import
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. start-mc-replicate-import-desc
|
|
|
|
The :mc:`mc replicate import` command imports JSON-formatted
|
|
:ref:`replication rules <minio-bucket-replication-serverside>` for a
|
|
MinIO bucket from ``STDIN``.
|
|
|
|
.. end-mc-replicate-import-desc
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: EXAMPLE
|
|
|
|
The following command imports the replication configuration for the
|
|
``mydata`` bucket on the ``myminio`` MinIO deployment:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc replicate import myminio/mydata < mydata-replication.json
|
|
|
|
.. tab-item:: SYNTAX
|
|
|
|
The command has the following syntax:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc [GLOBALFLAGS] import ALIAS
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-syntax
|
|
:end-before: end-minio-syntax
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
.. mc-cmd:: ALIAS
|
|
|
|
*Required* the :ref:`alias <alias>` of the MinIO deployment and full path to
|
|
the bucket or bucket prefix for which to import the replication rules. For
|
|
example:
|
|
|
|
.. code-block:: none
|
|
|
|
mc replicate import myminio/mybucket
|
|
|
|
Global Flags
|
|
~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-globals
|
|
:end-before: end-minio-mc-globals
|
|
|
|
Examples
|
|
--------
|
|
|
|
Import Existing Replication Rules
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Use :mc:`mc replicate import` to import bucket replication rules:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc replicate import ALIAS/PATH < bucket-replication-rules.json
|
|
|
|
- Replace :mc-cmd:`ALIAS <mc replicate import ALIAS>` with the
|
|
:mc:`alias <mc alias>` of the MinIO deployment.
|
|
|
|
- Replace :mc-cmd:`PATH <mc replicate import ALIAS>` with the path to the
|
|
bucket or bucket prefix.
|
|
|
|
Behavior
|
|
--------
|
|
|
|
Importing Configuration Overrides Existing Rules
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
:mc:`mc replicate import` replaces the current bucket replication
|
|
rules with those defined in the imported JSON configuration.
|
|
|
|
S3 Compatibility
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-s3-compatibility
|
|
:end-before: end-minio-mc-s3-compatibility
|