put-bucket-versioning

Описание

Устанавливает состояние версиирования для ведра S3 на Outposts. С помощью версиирования S3 вы можете сохранить несколько различных копий ваших объектов и восстановиться от непреднамеренных действий пользователя и сбоев приложения.

Вы можете установить состояние версиирования в одно из следующих значений:

• Включено - Включает версиирование для объектов в ведре. Все добавленные в ведро объекты получают уникальный идентификатор версии.
• Отключено - Отключает версиирование для объектов в ведре. Все объекты, добавленные в ведро, получают идентификатор версии null.

Если вы никогда не настраивали версиирование для своего ведра, у него нет состояния версиирования. В этом случае запрос GetBucketVersioning не возвращает значение состояния версиирования.

При включении версиирования S3 для каждого объекта в ведре у вас есть текущая версия и ноль или более неактуальных версий. Вы можете настроить правила жизненного цикла ведра S3 для истечения срока действия неактуальных версий по истечении определенного периода времени. Дополнительную информацию см. в разделе Создание и управление конфигурацией жизненного цикла для вашего ведра S3 на Outposts в Руководстве пользователя Amazon S3 .

Если у вас есть конфигурация жизненного цикла истечения срока действия объекта в вашем ведре без версиирования и вы хотите сохранить то же поведение постоянного удаления при включении версиирования, вы должны добавить политику истечения срока действия неактуальной версии. Конфигурация жизненного цикла истечения срока действия неактуальной версии будет управлять удалениями неактуальных версий объектов в ведре с включенным версиированием. Дополнительную информацию см. в разделе Версиирование в Руководстве пользователя Amazon S3 .

Все запросы Amazon S3 на Outposts REST API для этого действия требуют дополнительного параметра x-amz-outpost-id, который должен быть передан вместе с запросом. Кроме того, вы должны использовать префикс имени хоста конечной точки S3 на Outposts, а не s3-control. Пример синтаксиса запроса для Amazon S3 на Outposts, использующего префикс имени хоста конечной точки S3 на Outposts и x-amz-outpost-id, полученный с помощью ARN точки доступа, см. в разделе Примеры.

Следующие операции связаны с PutBucketVersioning для S3 на Outposts.

• GetBucketVersioning
• PutBucketLifecycleConfiguration
• GetBucketLifecycleConfiguration

См. также: AWS API Documentation

Синтаксис

  put-bucket-versioning
--account-id <value>
--bucket <value>
[--mfa <value>]
--versioning-configuration <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]

Параметры

--account-id (строка)

--bucket (строка)

--mfa (строка)

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

Сокращенная синтаксис:

MFADelete=string,Status=string

Синтаксис JSON:

{
  "MFADelete": "Enabled"|"Disabled",
  "Status": "Enabled"|"Suspended"
}

--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
• текст
• таблица
• yaml
• yaml-поток

--query (строка)

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

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

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

--version (строка)

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

--color (строка)

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

• включено
• выключено
• автоматически

--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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

Нет