Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Object Storage
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Бакеты
      • Создание бакета
      • Удаление бакета
      • Ограничение максимального размера бакета
      • Открытие публичного доступа к бакету
      • Шифрование бакета
      • Управление жизненными циклами объектов
      • Управление конфигурацией CORS
      • Редактирование ACL бакета
      • Включение механизма логированния
    • Объекты
      • Загрузка объекта
      • Получение информации об объекте
      • Скачивание объекта
      • Получение публичной ссылки на объект
      • Удаление объекта
      • Удаление частично загруженного объекта
      • Редактирование ACL объекта
    • Хостинг статических сайтов
      • Настройка хостинга
      • Поддержка собственного домена
      • Поддержка нескольких доменных имен
      • Настройка HTTPS
  • Концепции
    • Обзор
    • Бакет
    • Объект
    • Версионирование бакета
    • Жизненные циклы объектов
    • CORS
    • Хостинг статических сайтов
    • Подписанные (pre-signed) URL
    • Составная (multipart) загрузка
    • Список управления доступом (ACL)
    • Политика доступа (Bucket Policy)
    • Загрузка файла через HTML форму
    • Класс хранилища
    • Механизм логирования действий с бакетом
    • Резервное копирование
    • Протокол TLS
    • Квоты и лимиты
  • Инструменты
    • Все инструменты
    • Консольные клиенты
      • AWS CLI
      • S3cmd
    • Файловые браузеры
      • CyberDuck
      • WinSCP
    • SDK
      • AWS SDK для Java
      • Python SDK (boto)
    • FUSE
      • s3fs
      • goofys
  • HTTP API, совместимый с Amazon S3
    • Как пользоваться API
    • Подписывание запросов
    • Справочник API
      • Все сервисы и методы
      • Bucket
        • Все методы
        • create
        • getBucketEncryption
        • getMeta
        • listObjects
        • listBuckets
        • deleteBucket
        • deleteBucketEncryption
        • putBucketEncryption
        • putBucketVersioning
        • getBucketVersioning
        • putBucketLogging
        • getBucketLogging
        • listObjectVersions
      • Object
        • Все методы
        • upload
        • get
        • copy
        • getObjectMeta
        • delete
        • deleteMultipleObjects
        • options
      • Multipart upload
        • Общий порядок составной загрузки
        • startUpload
        • uploadPart
        • copyPart
        • listParts
        • abortUpload
        • completeUpload
        • listUploads
      • Static Website Hosting
        • Все методы
        • upload
        • get
        • delete
        • Коды ответов статического сайта
      • CORS
        • Все методы
        • XML-структура конфигурации CORS
        • upload
        • get
        • delete
      • Lifecycles
        • Все методы
        • XML-структура конфигурации жизненных циклов
        • upload
        • get
        • delete
      • ACL
        • Все методы
        • XML-структура конфигурации ACL
        • objectGetAcl
        • objectPutAcl
        • bucketGetAcl
        • bucketPutAcl
      • Bucket Policy
        • Все методы
        • GetBucketPolicy
        • PutBucketPolicy
        • DeleteBucketPolicy
        • Схема данных
        • Действия
        • Условия
      • Общие заголовки запросов
      • Общие заголовки ответов
      • Ответы
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • До 1 января 2019 года
      • С 1 января до 1 марта 2019 года
  • Вопросы и ответы
  1. HTTP API, совместимый с Amazon S3
  2. Справочник API
  3. Lifecycles
  4. XML-структура конфигурации жизненных циклов

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

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

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>
В этой статье:
  • Элементы
  • Пример
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»