Настройка правил

Конфигурация жизненного цикла представляет собой набор правил. Правила определяются в формате JSON и включают следующую информацию:

уникальное имя правила;
статус (Enabled — правило активно, Disabled — неактивно);
область применения правила (все объекты без исключения, объекты с указанным префиксом или с указанными тегами);
срок хранения объектов;
действие, которое нужно совершить после окончания срока хранения.

Параметры конфигурации

Параметр	Тип	Значение	Пример
`ID`	Строка	Уникальный идентификатор правила, который помогает различать его среди других правил	`"ID": "ArchiveOldLogs"`
`Status`	Строка	Указывает, активно ли правило. Возможные значения: `Enabled` — правило активно; `Disabled` — правило неактивно	`"Status": "Enabled"`
`Filter`	Объект	Определяет, к каким объектам применяется правило. Может включать элементы: `Prefix` — префикс объектов, к которым нужно применить правило; `Tags` — теги объектов, к которым нужно применить правило	`"Filter":` `{ "Prefix": "logs/", "Tags": [ {"Key": "Environment", "Value": "Production"} ] }`
`Expiration`	Объект	Определяет срок хранения объекта. Может включать элементы: `Days` — количество дней, по прошествии которых нужно удалить объект; `Date` — дата, после наступления которой объект будет удален	`"Expiration": { "Days": 365 }`
`NonCurrentVersionExpiration`	Объект	Указывает срок хранения неактуальных версий объекта. Может включать элементы: `NonCurrentDays` — количество дней до удаления неактуальной версии; `NewerNonCurrentVersions` — количество последних неактуальных версий, которые нужно хранить	`"NoncurrentVersionExpiration": { "NoncurrentDays": 30, "NewerNoncurrentVersions": 3 }`
`ExpiredObjectDeleteMarker`	Boolean	Указывает, нужно ли удалять маркеры удаления после удаления всех неактуальных версий объекта	`"Expiration": { "ExpiredObjectDeleteMarker": true }`
`AbortIncompleteMultipartUpload`	Объект	Указывает количество дней (`DaysAfterInitiation`), после которого незавершенные составные загрузки будут автоматически прерваны	`"AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 7 }`

Удаление объектов

С помощью правил жизненного цикла для объектов можно установить срок, по истечении которого они будут автоматически удаляться.

Вы можете сделать это двумя способами:

указать срок хранения в днях;
указать конкретную дату, когда объекты должны быть удалены.

Операция удаления имеет свою специфику в зависимости от того, включено ли в бакете версионирование:

Если версионирование не включено, объект будет удален после того, как закончится срок хранения.
Если версионирование включено, операция удаления затронет только текущую версию объекта. Будет создан маркер удаления — он станет текущей версией, а предыдущие версии объекта останутся доступными.
Если версионирование приостановлено, будет создан маркер удаления с идентификатором null, который станет текущей версией объекта. Текущая версия при этом будет удалена без возможности восстановления, а все предыдущие — останутся доступными.

Удаление по прошествии заданного срока

Вы можете указать в правилах количество дней, по прошествии которого объекты будут считаться подлежащими удалению. Срок хранения объектов всегда округляется до 00:00 UTC следующего дня после достижения указанных даты и времени.

Например, если вы загрузили объект 20 ноября 2025 года в 14:30 MSK (в 11:30 UTC) и назначили для него срок хранения в 1 день, этот срок истечет в 00:00 UTC (03:00 MSK) 22 ноября 2025 года. Начиная с 00:00 UTC 22 ноября 2025 года объект будет считаться подлежащим удалению.

При расчете сроков учитываются только полные дни. Например, если вы загрузили объект 21 ноября 2025 года в 23:59 MSK (в 20:59 UTC) и установили для него срок хранения в 1 день, этот срок истечет в 00:00 UTC (03:00 MSK) 23 ноября.

1
{
2
  "Rules": [
3
    {
4
      "ID": "DeleteObjectsInThreeDays",
5
      "Status": "Enabled",
6
      "Filter": {
7
        "Prefix": ""
8
      },
9
      "Expiration": {
10
        "Days": 7
11
      }
12
    }
13
  ]
14
}

1
{
2
  "Rules": [
3
    {
4
      "ID": "DeleteObjectsWithTheSpecifiedPrefixInAWeek",
5
      "Status": "Enabled",
6
      "Filter": {
7
        "Prefix": "logs/"
8
      },
9
      "Expiration": {
10
        "Days": 7
11
      }
12
    }
13
  ]
14
}

Это правило распространяется не на все объекты в бакете, а только на объекты с префиксом logs/. Для таких объектов устанавливается срок хранения в 7 дней. После истечения этого срока они удаляются.

1
{
2
  "Rules": [
3
    {
4
      "ID": "DeleteTaggedObjectsInAWeek",
5
      "Filter": {
6
        "And": {
7
          "Prefix": "",
8
          "Tags": [
9
            {
10
              "Key": "application",
11
              "Value": "logs"
12
            },
13
            {
14
              "Key": "documents",
15
              "Value": "drafts"
16
            }
17
          ]
18
        }
19
      },
20
      "Status": "Enabled",
21
      "Expiration": {
22
        "Days": 7
23
      }
24
    }
25
  ]
26
}

Это правило распространется не на все объекты в бакете, а только на объекты с тегами application:logs и documents:drafts. Для таких объектов устанавливается срок хранения в 7 дней. После истечения этого срока они удаляются.

Удаление в указанную дату

В правиле можно указать конкретную дату, когда будет удален объект. В этом случае объект считается подлежащим удалению начиная с 00:00 UTC этой даты независимо от времени загрузки.

1
{
2
  "Rules": [
3
    {
4
      "ID": "DeleteOnSpecificDate",
5
      "Status": "Enabled",
6
      "Filter": {},
7
      "Expiration": {
8
        "Date": "2025-12-31T00:00:00Z"
9
      }
10
    }
11
  ]
12
}

Удаление неактуальных версий

С помощью правил жизненного цикла можно настроить автоматическое удаление неактуальных версий объекта.

1
{
2
  "Rules": [
3
    {
4
      "ID": "DeleteNonCurrentVersionsAfter30Days",
5
      "Status": "Enabled",
6
      "Filter": {
7
        "Prefix": ""
8
      },
9
      "NoncurrentVersionExpiration": {
10
        "NoncurrentDays": 30
11
      }
12
    }
13
  ]
14
}

Это правило указывает, что версии объекта утрачивают актуальность через 30 дней. После загрузки новой версии все предыдущие версии хранятся 30 дней, а затем удаляются.

1
{
2
  "Rules": [
3
    {
4
      "ID": "LimitNonCurrentVersions",
5
      "Status": "Enabled",
6
      "Filter": {
7
        "Prefix": ""
8
      },
9
      "NoncurrentVersionExpiration": {
10
        "NewerNoncurrentVersions": 3
11
      }
12
    }
13
  ]
14
}

Это правило не только устанавливает срок хранения для неактуальных версий, но и ограничивает их количество. Оно указывает, что в бакете должны храниться только 3 последние неактуальные версии объекта. Все старые неактуальные версии автоматически удаляются.

Удаление маркеров удаления

Когда из бакета с версионированием удаляется текущая версия объекта, а неактуальных версий больше не остается, маркер удаления становится единственной версией объекта. Удалять такие маркеры можно с помощью правила ExpiredObjectDeleteMarker.

1
{
2
  "Rules": [
3
    {
4
      "ID": "DeleteAllLogs",
5
      "Filter": {
6
        "Prefix": "logs/"
7
      },
8
      "Status": "Enabled",
9
      "Expiration": {
10
        "ExpiredObjectDeleteMarker": true
11
      },
12
      "NoncurrentVersionExpiration": {
13
        "NewerNoncurrentVersions": 10,
14
        "NoncurrentDays": 30
15
      }
16
    }
17
  ]
18
}

Это правило применяется ко все объектом с префиксом logs/. Оно указывает, что в бакете должны храниться 10 неактуальных версий объекта. Версия становится неактуальной через 30 дней с момента загрузки. После удаления последней неактуальной версии оставшийся маркер удаления удаляется автоматически.

1
{
2
  "Rules": [
3
    {
4
      "Status": "Enabled",
5
      "Prefix": "",
6
      "Expiration": {
7
        "Days": 30,
8
        "ExpiredObjectDeleteMarker": true
9
      }
10
    }
11
  ]
12
}

Это правило указывает, что маркер удаления будет удален через 30 дней после создания.

Остановка незавершенных загрузок

Незавершенные загрузки можно удалять с помощью правил жизненного цикла. Это поможет не прибегать к ручному удалению, а также упростит поддержание порядка и чистоты данных.

1
{
2
  "Rules": [
3
    {
4
      "ID": "AbortAllIncompleteUploadsAfter7Days",
5
      "Status": "Enabled",
6
      "Filter": {
7
        "Prefix": ""
8
      },
9
      "AbortIncompleteMultipartUpload": {
10
        "DaysAfterInitiation": 7
11
      }
12
    }
13
  ]
14
}

Это правило предписывает останавливать все незавершенные загрузки через 7 дней после начала.

1
{
2
  "Rules": [
3
    {
4
      "ID": "AbortUploadsForLogsAfter3Days",
5
      "Status": "Enabled",
6
      "Filter": {
7
        "Prefix": "logs/"
8
      },
9
      "AbortIncompleteMultipartUpload": {
10
        "DaysAfterInitiation": 3
11
      }
12
    }
13
  ]
14
}

Это правило предписывает останавливать не все незавершенные загрузки, а только загрузки объектов с префиксом logs/. Загрузки будут прерваны через 3 дня после начала.

1
{
2
  "Rules": [
3
    {
4
      "ID": "AbortTaggedUploadsAfter5Days",
5
      "Status": "Enabled",
6
      "Filter": {
7
        "Tags": [
8
          {
9
            "Key": "Project",
10
            "Value": "Archive"
11
          }
12
        ]
13
      },
14
      "AbortIncompleteMultipartUpload": {
15
        "DaysAfterInitiation": 5
16
      }
17
    }
18
  ]
19
}

Это правило предписывает останавливать не все незавершенные загрузки, а только загрузки объектов c тегом Project:Archive. Загрузки будут остановлены через 5 дней после начала.