.. _minio-mc-ilm-import:

=================
``mc ilm import``
=================

.. default-domain:: minio

.. contents:: Table of Contents
   :local:
   :depth: 2

.. mc:: mc ilm import

.. versionchanged:: RELEASE.2022-12-24T15-21-38Z

   ``mc ilm import`` replaced by :mc-cmd:`mc ilm rule 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:`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
