Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

изменение-резерва-емкости-флота

Описание

Изменяет флот резервирования емкости.

При изменении общей целевой емкости флота резервирования емкости, флот автоматически создает новые резервации емкости или изменяет или отменяет существующие резервации емкости во флоте, чтобы соответствовать новой общей целевой емкости. При изменении даты окончания срока действия флота, даты окончания срока действия всех отдельных резерваций емкости во флоте обновляются соответствующим образом.

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

Синтаксис

  modify-capacity-reservation-fleet
--capacity-reservation-fleet-id <value>
[--total-target-capacity <value>]
[--end-date <value>]
[--dry-run | --no-dry-run]
[--remove-end-date | --no-remove-end-date]
[--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]

Параметры

--capacity-reservation-fleet-id (строка)

Идентификатор флота резервирования емкости, который требуется изменить.

--total-target-capacity (целое число)

Общее количество единиц емкости, которые должны быть зарезервированы флотом резервирования емкости. Это значение вместе с весами типов экземпляров, которые вы назначаете каждому типу экземпляра, используемого флотом, определяет количество экземпляров, для которых флот резервирует емкость. Оба значения основаны на единицах, имеющих смысл для вашей рабочей нагрузки. Дополнительные сведения см. в разделе Общая целевая емкость в Руководстве пользователя Amazon EC2 .

--end-date (метка времени)

Дата и время, когда флот резервирования емкости истекает. Когда флот резервирования емкости истекает, его состояние изменяется на expired и все резервации емкости во флоте истекают.

Срок действия флота резервирования емкости истекает в течение часа после указанного времени. Например, если вы укажете 5/31/2019 , 13:30:55 , флот резервирования емкости гарантированно истечет между 13:30:55 и 14:30:55 по 5/31/2019 .

Вы не можете указать EndDate и RemoveEndDate в одном запросе.

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

Проверяет, имеете ли вы необходимые разрешения для действия, не отправляя фактический запрос, и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation . В противном случае это UnauthorizedOperation .

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

Указывает, нужно ли удалить дату окончания срока действия из флота резервирования емкости. Если вы удалите дату окончания срока действия, флот резервирования емкости не истечет и останется активным до тех пор, пока вы явно не отменят его с помощью действия CancelCapacityReservationFleet.

Вы не можете указать RemoveEndDate и EndDate в одном запросе.

--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.

Примеры

Примечание

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

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

Пример 1: Изменение общей целевой емкости флота резервирования емкости

Следующий modify-capacity-reservation-fleet пример изменяет общую целевую емкость указанного флота резервирования емкости. При изменении общей целевой емкости флота резервирования емкости, флот автоматически создает новые резервации емкости или изменяет или отменяет существующие резервации емкости во флоте, чтобы соответствовать новой общей целевой емкости. Нельзя пытаться выполнить дополнительные изменения в флоте, пока он находится в состоянии modifying.

aws ec2 modify-capacity-reservation-fleet \
    --capacity-reservation-fleet-id crf-01234567890abcedf \
    --total-target-capacity 160

Вывод:

{
    "Return": true
}

Пример 2: Изменение даты окончания срока действия флота резервирования емкости

Следующий modify-capacity-reservation-fleet пример изменяет дату окончания срока действия указанного флота резервирования емкости. При изменении даты окончания срока действия флота, даты окончания срока действия всех отдельных резерваций емкости обновляются соответствующим образом. Нельзя пытаться выполнить дополнительные изменения в флоте, пока он находится в состоянии modifying.

aws ec2 modify-capacity-reservation-fleet \
    --capacity-reservation-fleet-id crf-01234567890abcedf \
    --end-date 2022-07-04T23:59:59.000Z

Вывод:

{
    "Return": true
}

Дополнительные сведения о флотах резервирования емкости см. в разделе Флоты резервирования емкости в Руководстве пользователя Amazon EC2.

Вывод

Возврат -> (логическое значение)

Возвращает true, если запрос выполнен успешно; в противном случае возвращает ошибку.

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

Spec-Zone.ru

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