put-bucket-lifecycle-configuration

Описание

Создаёт новую конфигурацию жизненного цикла для ведра или заменяет существующую конфигурацию жизненного цикла. Имейте в виду, что это перезапишет существующую конфигурацию жизненного цикла, поэтому, если вы хотите сохранить какие-либо данные конфигурации, они должны быть включены в новую конфигурацию жизненного цикла. Для получения информации о конфигурации жизненного цикла см. Управление жизненным циклом хранилища .

Конфигурацию жизненного цикла вы указываете в теле запроса. Конфигурация жизненного цикла задаётся в формате XML, состоящем из одного или нескольких правил. Конфигурация жизненного цикла Amazon S3 может содержать до 1000 правил. Этот лимит не настраивается.

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

Правило жизненного цикла состоит из следующего:

• Фильтр, определяющий подмножество объектов, на которые распространяется правило. Фильтр может основываться на префиксе имени ключа, тегах объекта, размере объекта или любом сочетании этих параметров.
• Статус, указывающий, действует ли правило.
• Один или несколько действий перехода и истечения срока действия жизненного цикла, которые вы хотите, чтобы Amazon S3 выполнял для объектов, определённых фильтром. Если состояние вашего ведра поддерживает версионирование или приостановлено версионирование, у вас может быть много версий одного и того же объекта (одна текущая версия и ноль или более нетекущих версий). Amazon S3 предоставляет предварительно определённые действия, которые вы можете указать для текущих и нетекущих версий объектов.

Для получения дополнительной информации см. Управление жизненным циклом объектов и Элементы конфигурации жизненного цикла .

• Разрешения ведер общего назначения - По умолчанию все ресурсы Amazon S3 являются закрытыми, включая ведра, объекты и связанные подресурсы (например, конфигурация жизненного цикла и конфигурация веб-сайта). Только владелец ресурса (то есть учётная запись Amazon Web Services, создавшая его) может получить доступ к ресурсу. Владелец ресурса может по желанию предоставить разрешения доступа другим, написав политику доступа. Для этой операции пользователь должен иметь разрешение s3:PutLifecycleConfiguration. Вы также можете явно запретить разрешения. Явный отказ также отменяет любые другие разрешения. Если вы хотите заблокировать пользователей или учётные записи от удаления или удаления объектов из вашего ведра, вы должны запретить им разрешения на следующие действия:
  • s3:DeleteObject
  • s3:DeleteObjectVersion
  • s3:PutLifecycleConfiguration Дополнительную информацию о разрешениях см. в Управление разрешениями доступа к вашим ресурсам Amazon S3 .
• Разрешения ведер каталогов - Для использования этой операции в политике на основе идентификатора IAM требуется разрешение s3express:PutLifecycleConfiguration. Доступ к этой операции API через разные учётные записи не поддерживается. Владелец ресурса может по желанию предоставить разрешения доступа другим, создав для них роль или пользователя, пока они находятся в той же учётной записи, что и владелец и ресурс. Дополнительную информацию о политиках и разрешениях ведер каталогов см. в Разрешение доступа к API региональных конечных точек с помощью IAM в Руководстве пользователя Amazon S3 .

Следующие операции связаны с PutBucketLifecycleConfiguration :

• GetBucketLifecycleConfiguration
• DeleteBucketLifecycle

См. также: Документация API AWS

Синопсис

  put-bucket-lifecycle-configuration
--bucket <value>
[--checksum-algorithm <value>]
[--lifecycle-configuration <value>]
[--expected-bucket-owner <value>]
[--transition-default-minimum-object-size <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--bucket (строка)

--checksum-algorithm (строка)

--lifecycle-configuration (структура)

Синтаксис JSON:

{
  "Rules": [
    {
      "Expiration": {
        "Date": timestamp,
        "Days": integer,
        "ExpiredObjectDeleteMarker": true|false
      },
      "ID": "string",
      "Prefix": "string",
      "Filter": {
        "Prefix": "string",
        "Tag": {
          "Key": "string",
          "Value": "string"
        },
        "ObjectSizeGreaterThan": long,
        "ObjectSizeLessThan": long,
        "And": {
          "Prefix": "string",
          "Tags": [
            {
              "Key": "string",
              "Value": "string"
            }
            ...
          ],
          "ObjectSizeGreaterThan": long,
          "ObjectSizeLessThan": long
        }
      },
      "Status": "Enabled"|"Disabled",
      "Transitions": [
        {
          "Date": timestamp,
          "Days": integer,
          "StorageClass": "GLACIER"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"DEEP_ARCHIVE"|"GLACIER_IR"
        }
        ...
      ],
      "NoncurrentVersionTransitions": [
        {
          "NoncurrentDays": integer,
          "StorageClass": "GLACIER"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"DEEP_ARCHIVE"|"GLACIER_IR",
          "NewerNoncurrentVersions": integer
        }
        ...
      ],
      "NoncurrentVersionExpiration": {
        "NoncurrentDays": integer,
        "NewerNoncurrentVersions": integer
      },
      "AbortIncompleteMultipartUpload": {
        "DaysAfterInitiation": integer
      }
    }
    ...
  ]
}

--expected-bucket-owner (строка)

--transition-default-minimum-object-size (строка)

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводится пример входного JSON, который может быть использован в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, будет выведен пример входного YAML, который может быть использован с --cli-input-yaml. Если предоставлено значение output, то проверяются входные данные команды и возвращается пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку логов.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (булево)

Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из вашего файла с данными доступа.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

• on
• off
• auto

--no-sign-request (булево)

Не подписывать запросы. Данные доступа не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл с сертификатом CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию - 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию - 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для использования для двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строки base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (булево)

Отключить пагинатор CLI для вывода.

--cli-auto-prompt (булево)

Автоматически запросить входные параметры CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы входных параметров CLI.

Примеры

Следующая команда применяет конфигурацию жизненного цикла к ведру с именем amzn-s3-demo-bucket:

aws s3api put-bucket-lifecycle-configuration --bucket amzn-s3-demo-bucket --lifecycle-configuration  file://lifecycle.json

Файл lifecycle.json - это JSON-документ в текущей папке, который определяет две правила:

{
    "Rules": [
        {
            "ID": "Move rotated logs to Glacier",
            "Prefix": "rotated/",
            "Status": "Enabled",
            "Transitions": [
                {
                    "Date": "2015-11-10T00:00:00.000Z",
                    "StorageClass": "GLACIER"
                }
            ]
        },
        {
            "Status": "Enabled",
            "Prefix": "",
            "NoncurrentVersionTransitions": [
                {
                    "NoncurrentDays": 2,
                    "StorageClass": "GLACIER"
                }
            ],
            "ID": "Move old versions to Glacier"
        }
    ]
}

Первое правило перемещает файлы с префиксом rotated в Glacier в указанную дату. Второе правило перемещает старые версии объектов в Glacier, когда они больше не являются текущими. Сведения о допустимых форматах временных меток см. в разделе Указание значений параметров в руководстве пользователя AWS CLI.

Вывод

TransitionDefaultMinimumObjectSize -> (строка)