Spec-Zone.ru › AWS CLI v2

[ aws . ssm ]

обновление-окна-технического-обслуживания

Описание

Обновляет существующее окно технического обслуживания. Изменяются только указанные параметры.

Примечание

Значение, которое вы указываете для Duration, определяет конкретное время окончания окна технического обслуживания на основе времени его начала. Задачи окна технического обслуживания не допускаются к запуску после времени окончания, уменьшенного на количество часов, указанных для Cutoff. Например, если окно технического обслуживания начинается в 15:00, продолжительность составляет три часа, а значение, указанное для Cutoff, равно одному часу, задачи окна технического обслуживания не могут начинаться после 17:00.

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

Синтаксис

  update-maintenance-window
--window-id <value>
[--name <value>]
[--description <value>]
[--start-date <value>]
[--end-date <value>]
[--schedule <value>]
[--schedule-timezone <value>]
[--schedule-offset <value>]
[--duration <value>]
[--cutoff <value>]
[--allow-unassociated-targets | --no-allow-unassociated-targets]
[--enabled | --no-enabled]
[--replace | --no-replace]
[--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]

Параметры

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

Идентификатор окна технического обслуживания для обновления.

--name (строка)

Имя окна технического обслуживания.

--description (строка)

Необязательное описание запроса на обновление.

--start-date (строка)

Дата и время активации окна технического обслуживания в формате ISO-8601 Extended. StartDate позволяет отложить активацию окна технического обслуживания до указанной будущей даты.

Примечание

При использовании расписания по частоте, если вы предоставляете дату начала, которая произошла в прошлом, текущая дата и время используются в качестве даты начала.

--end-date (строка)

Дата и время деактивации окна технического обслуживания в формате ISO-8601 Extended. EndDate позволяет установить дату и время в будущем, когда окно технического обслуживания больше не будет работать.

--schedule (строка)

Расписание окна технического обслуживания в формате cron или выражения частоты.

--schedule-timezone (строка)

Часовой пояс, на основе которого выполняются запланированные операции окна технического обслуживания, в формате IANA. Например: “America/Los_Angeles”, “UTC” или “Asia/Seoul”. Дополнительную информацию см. в базе данных часовых поясов на веб-сайте IANA.

--schedule-offset (целое число)

Количество дней ожидания после даты и времени, указанных в выражении cron, прежде чем запустить окно технического обслуживания.

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

cron(30 23 ? * TUE#3 *)

Если смещение расписания равно 2, окно технического обслуживания не будет запущено до двух дней позже.

--duration (целое число)

Продолжительность окна технического обслуживания в часах.

--cutoff (целое число)

Количество часов до окончания окна технического обслуживания, когда Amazon Web Services Systems Manager прекращает планирование новых задач для выполнения.

--allow-unassociated-targets | --no-allow-unassociated-targets (логическое значение)

Требуется ли регистрация целевых объектов в окне технического обслуживания перед определением задач для этих целевых объектов.

--enabled | --no-enabled (логическое значение)

Включено ли окно технического обслуживания.

--replace | --no-replace (логическое значение)

Если True, то все поля, необходимые для операции CreateMaintenanceWindow, также требуются для этого запроса API. Необязательные поля, которые не указаны, устанавливаются в null.

--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 для вывода.

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

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

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

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, во всех примерах используются правила цитирования unix-подобных оболочек. Эти примеры нужно адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Пример 1: Обновление окна технического обслуживания

В следующем update-maintenance-window примере обновляется имя окна технического обслуживания.

aws ssm update-maintenance-window \
    --window-id "mw-1a2b3c4d5e6f7g8h9" \
    --name "My-Renamed-MW"

Вывод:

{
    "Cutoff": 1,
    "Name": "My-Renamed-MW",
    "Schedule": "cron(0 16 ? * TUE *)",
    "Enabled": true,
    "AllowUnassociatedTargets": true,
    "WindowId": "mw-1a2b3c4d5e6f7g8h9",
    "Duration": 4
}

Пример 2: Отключение окна технического обслуживания

В следующем update-maintenance-window примере отключается окно технического обслуживания.

aws ssm update-maintenance-window \
    --window-id "mw-1a2b3c4d5e6f7g8h9" \
    --no-enabled

Пример 3: Включение окна технического обслуживания

В следующем update-maintenance-window примере включается окно технического обслуживания.

aws ssm update-maintenance-window \
    --window-id "mw-1a2b3c4d5e6f7g8h9" \
    --enabled

Дополнительную информацию см. в разделе Обновление окна технического обслуживания (AWS CLI) в Руководстве пользователя AWS Systems Manager.

Вывод

WindowId -> (строка)

Идентификатор созданного окна технического обслуживания.

Name -> (строка)

Имя окна технического обслуживания.

Description -> (строка)

Необязательное описание обновления.

StartDate -> (строка)

Дата и время активации окна технического обслуживания в формате ISO-8601 Extended. Окно технического обслуживания не будет запущено до указанного времени.

EndDate -> (строка)

Дата и время деактивации окна технического обслуживания в формате ISO-8601 Extended. Окно технического обслуживания не будет запущено после указанного времени.

Schedule -> (строка)

Расписание окна технического обслуживания в формате cron или выражения частоты.

ScheduleTimezone -> (строка)

Часовой пояс, на основе которого выполняются запланированные операции окна технического обслуживания, в формате IANA. Например: “America/Los_Angeles”, “UTC” или “Asia/Seoul”. Дополнительную информацию см. в базе данных часовых поясов на веб-сайте IANA.

ScheduleOffset -> (целое число)

Количество дней ожидания для запуска окна технического обслуживания после даты и времени, указанных в выражении cron.

Duration -> (целое число)

Продолжительность окна технического обслуживания в часах.

Cutoff -> (целое число)

Количество часов до окончания окна технического обслуживания, когда Amazon Web Services Systems Manager прекращает планирование новых задач для выполнения.

AllowUnassociatedTargets -> (логическое значение)

Требуется ли регистрация целевых объектов в окне технического обслуживания перед определением задач для этих целевых объектов.

Enabled -> (логическое значение)

Включено ли окно технического обслуживания.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API