Подключиться
Yandex Object Storage

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

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> -->
        </Expiration>
        ...
    </Rule>
    <Rule>
      ...
    </Rule>
    ...
</LifecycleConfiguration>

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

Элементы

Элемент Описание
Date Дата исполнения правила.

Формат — ISO 8601, например, YYYY-MM-DD. Время — всегда 00:00 UTC.

Путь: LifecycleConfiguration\Rule\Expiration\Date.
Days Интервал исполнения правила.

Задается количеством дней после загрузки объекта.

Путь: LifecycleConfiguration\Rule\Expiration\Days.
Expiration Правило для удаления объекта из Object Storage.

Содержит элемент Days или Date, который определяет сроки исполнения действия.

Путь: 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\.

Пример

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

  • Перемещение в холодное хранилище через 30 дней после загрузки в Object Storage.
  • Удаление из Object Storage через 365 дней после загрузки.
<LifecycleConfiguration>
    <Rule>
        <ID>Переместить и потом удалить</ID>
        <Status>Enabled</Status>
        <Filter>
           <Prefix></Prefix>
        </Filter>
        <Transition>
            <StorageClass>COLD</StorageClass>
            <Days>30</Days>
        </Transition>
        <Expiration>
            <Days>365</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>