mirror of
https://github.com/minio/docs.git
synced 2025-09-16 07:22:15 +03:00
127 lines
2.9 KiB
ReStructuredText
127 lines
2.9 KiB
ReStructuredText
.. _minio-mc-ilm-import:
|
|
|
|
=================
|
|
``mc ilm import``
|
|
=================
|
|
|
|
.. default-domain:: minio
|
|
|
|
.. contents:: Table of Contents
|
|
:local:
|
|
:depth: 2
|
|
|
|
.. mc:: mc ilm import
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. start-mc-ilm-import-desc
|
|
|
|
The :mc:`mc ilm import` command imports an object lifecycle management
|
|
configuration and applies it to a MinIO bucket.
|
|
|
|
.. end-mc-ilm-import-desc
|
|
|
|
The :mc:`mc ilm import` command imports from ``STDIN`` by default. You can
|
|
input the contents from a ``.json`` file, such as one produced by
|
|
:mc:`mc ilm export`.
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: EXAMPLE
|
|
|
|
The following command imports the lifecycle management configuration from
|
|
``mydata-lifecycle-config.json`` and applies it to the ``mydata`` bucket
|
|
on the ``myminio`` deployment:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc ilm import myminio/mydata <> mydata-lifecycle-config.json
|
|
|
|
.. tab-item:: SYNTAX
|
|
|
|
The command has the following syntax:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc [GLOBALFLAGS] ilm import ALIAS < STDIN
|
|
|
|
.. 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>` and full path to the bucket on the MinIO
|
|
deployment into which to import object lifecycle management rules. For
|
|
example:
|
|
|
|
.. code-block:: none
|
|
|
|
mc ilm import myminio/mydata < bucket-lifecycle.json
|
|
|
|
|
|
|
|
Global Flags
|
|
~~~~~~~~~~~~
|
|
|
|
.. include:: /includes/common-minio-mc.rst
|
|
:start-after: start-minio-mc-globals
|
|
:end-before: end-minio-mc-globals
|
|
|
|
Examples
|
|
--------
|
|
|
|
Import the Bucket Lifecycle Management Configuration
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. tab-set::
|
|
|
|
.. tab-item:: Example
|
|
|
|
The following command imports the bucket lifecycle management
|
|
configuration from the ``bucket-lifecycle.json`` file:
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc ilm import myminio/mybucket < bucket-lifecycle.json
|
|
|
|
.. tab-item:: Syntax
|
|
|
|
.. code-block:: shell
|
|
:class: copyable
|
|
|
|
mc ilm import ALIAS < file.json
|
|
|
|
- Replace ``ALIAS`` with the :ref:`alias <alias>` of the MinIO
|
|
deployment and the bucket into which to import object lifecycle
|
|
management rules:
|
|
|
|
``myminio/mydata``
|
|
|
|
- Replace ``file.json`` with the name of the file from which to import the
|
|
lifecycle management rules.
|
|
|
|
|
|
Behavior
|
|
--------
|
|
|
|
Importing Configuration Overrides Existing Rules
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
:mc-cmd:`mc ilm import` replaces the current bucket lifecycle management
|
|
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
|