Конфигурация жизненных циклов объектов в бакете

Статья создана

Элементы
Пример

Object Storage позволяет управлять жизненными циклами объектов в бакете. Для загрузки конфигурации жизненных циклов в Object Storage необходимо сформировать XML-документ, описанный в этом разделе. При скачивании существующей конфигурации, вы получите документ такого же формата.

Общий вид конфигурации:

<LifecycleConfiguration>
    <Rule>
        <ID>Описание правила</ID>
        <Status>{Enabled|Disabled}</Status>
        <Filter>
           <Prefix>префикс_ключа</Prefix>
        </Filter>

        <Transition>
            <StorageClass>Идентификатор класса хранилища</StorageClass>
            <!-- <Date> или <Days> -->
        </Transition>

        <Expiration>
            <!-- <Date> или <Days> -->
            <!-- <ExpiredObjectDeleteMarker> -->
        </Expiration>

        <NoncurrentVersionTransition>
            <StorageClass>Идентификатор класса хранилища</StorageClass>
            <NoncurrentDays>Перенос версий, которые старше указанного количества дней</NoncurrentDays>
        </NoncurrentVersionTransition>

        <NoncurrentVersionExpiration>
            <NoncurrentDays>Удаление версий, которые старше указанного количества дней</NoncurrentDays>
        </NoncurrentVersionExpiration>

        <AbortIncompleteMultipartUpload>
            <DaysAfterInitiation>Удаление загрузок, не завершенных за указанное количество дней</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
        ...
    </Rule>
    <Rule>
      ...
    </Rule>
    ...
</LifecycleConfiguration>

Конфигурация может содержать до 1000 правил.

Элементы

Элемент	Описание
`AbortIncompleteMultipartUpload`	Правило для удаления загрузок, не завершенных за указанное количество дней. Содержит элемент `DaysAfterInitiation`, который определяет срок исполнения правила. Путь: `LifecycleConfiguration\Rule\AbortIncompleteMultipartUpload\DaysAfterInitiation`.
`Date`	Дата исполнения правила. Формат — ISO 8601, например, `YYYY-MM-DD`. Время — всегда 00:00 UTC. Путь: `LifecycleConfiguration\Rule\Expiration\Date`.
`Days`	Интервал исполнения правила. Задается количеством дней после загрузки объекта. Путь: `LifecycleConfiguration\Rule\Expiration\Days`.
`Expiration`	Правило для удаления объекта из Object Storage. Содержит элемент `Days` или `Date`, который определяет сроки исполнения действия. Дополнительно может содержать `ExpiredObjectDeleteMarker` — маркер удаления объекта с истекшим сроком действия, который указывает, удалит ли Object Storage маркер удаления при отсутствии неактивных версий. Путь: `LifecycleConfiguration\Rule\Expiration`.
`Filter`	Фильтр объектов. Содержит не более одного элемента `Prefix`. Если установить пустой фильтр `<Filter></Filter>`, то правило применяется ко всем объектам в бакете. Путь: `LifecycleConfiguration\Rule\Filter`.
`ID`	Уникальный идентификатор правила. Произвольный текст длиной до 255 символов, например "Удалить через 20 дней". Необязательный параметр, который можно использовать для поиска правила в конфигурации. Если идентификатор не указан, то Object Storage генерирует его автоматически. Путь: `LifecycleConfiguration\Rule\ID`.
`LifecycleConfiguration`	Корневой элемент XML-документа. Может содержать до 1000 элементов `Rule`. Путь: `LifecycleConfiguration`.
`Prefix`	Префикс ключа. Используется для фильтрации объектов, попадающих под действие правила. Примеры префиксов для ключа `some/long/object/key`: `some`, `some/`, `some/lo`. Фильтр может содержать только один префикс. Путь:`LifecycleConfiguration\Rule\Filter\Prefix`.
`Rule`	Описание правила. Объекты, попадающие под действие правила задаются элементом `Filter`. Действия над объектами определяются элементами `Transition` и `Expiration`. Действий каждого типа может быть несколько. Путь: `LifecycleConfiguration\Rule`.
`Status`	Статус правила. Правило можно активировать, установив `<Status>Enabled</Status>`, или отключить, установив `<Status>Disabled</Status>`. Путь: `LifecycleConfiguration\Rule\Status`.
`StorageClass`	Класс хранилища объекта. Путь: `LifecycleConfiguration\Rule\Transition\StorageClass`.
`Transition`	Правило для изменения класса хранилища объекта. Содержит элемент `StorageClass`, который определяет целевой класс хранилища, а также элемент `Date` или `Days`, который определяет срок исполнения действия. Переместить объекты можно только из стандартного в холодное хранилище. Путь: `LifecycleConfiguration\Rule\Transition\`.
`NoncurrentVersionTransition`	Правило для изменения класса хранилища неактивных версий объекта. Это правило применяется не ко всему объекту, а только к его неактивным версиям. Содержит элемент `StorageClass`, который определяет целевой класс хранилища, а также элемент `NoncurrentDays`, который определяет срок исполнения действия. Переместить объекты можно только из стандартного в холодное хранилище. Путь: `LifecycleConfiguration\Rule\NoncurrentVersionTransition`.
`NoncurrentVersionExpiration`	Правило для удаления неактивных версий объекта из Object Storage. Это правило применяется не ко всему объекту, а только к его неактивным версиям. Содержит элемент `NoncurrentDays`, который определяет сроки исполнения действия. Путь: `LifecycleConfiguration\Rule\NoncurrentVersionExpiration`.

Пример

Приведенное ниже правило для всех объектов, загруженных в бакет, задает:

Перемещение в холодное хранилище через 30 дней после загрузки в Object Storage.
Удаление из Object Storage через 365 дней после загрузки.
Удаление из Object Storage незавершенных загрузок через 5 дней после начала загрузки.

<LifecycleConfiguration>
    <Rule>
        <ID>Переместить и потом удалить</ID>
        <Status>Enabled</Status>
        <Filter>
           <Prefix></Prefix>
        </Filter>
        <Transition>
            <StorageClass>COLD</StorageClass>
            <Days>30</Days>
        </Transition>
        <Expiration>
            <Days>365</Days>
        </Expiration>
        <AbortIncompleteMultipartUpload>
            <DaysAfterInitiation>5</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
    </Rule>
</LifecycleConfiguration>

Конфигурация жизненных циклов объектов в бакете

Элементы

Пример

Была ли статья полезна?