modify-capacity-reservation

Описание

Изменяет емкость резерва емкости, возможность использования экземпляров и условия, при которых он будет освобожден. Вы не можете изменить тип экземпляра, оптимизацию EBS, платформу, параметры хранилища экземпляра, зону доступности или арендатора резерва емкости. Если вам необходимо изменить любой из этих атрибутов, мы рекомендуем отменить резерв емкости и затем создать новый с необходимыми атрибутами. Дополнительную информацию см. в разделе Изменение активного резерва емкости.

Допустимые изменения зависят от состояния резерва емкости:

• assessing или scheduled состояние - Вы можете изменить только теги.
• pending состояние - Вы не можете изменить резерв емкости.
• active состояние, но всё ещё в рамках срока обязательства - Вы не можете уменьшить количество экземпляров или установить дату окончания, которая находится в рамках срока обязательства. Все остальные изменения разрешены.
• active состояние без срока обязательства или истекший срок обязательства - Все изменения разрешены.
• expired , cancelled , unsupported или failed состояние - Вы не можете изменить резерв емкости.

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

Синтаксис

  modify-capacity-reservation
--capacity-reservation-id <value>
[--instance-count <value>]
[--end-date <value>]
[--end-date-type <value>]
[--accept | --no-accept]
[--dry-run | --no-dry-run]
[--additional-info <value>]
[--instance-match-criteria <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]

Параметры

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

--instance-count (целое число)

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

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

--accept | --no-accept (булево)

--dry-run | --no-dry-run (булево)

--additional-info (строка)

--instance-match-criteria (строка)

--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 (int)

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 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.

Примеры

Пример 1: Изменение количества экземпляров, резервируемых резервом емкости

Следующий пример modify-capacity-reservation изменяет количество экземпляров, для которых резерв емкости резервирует емкость.

aws ec2 modify-capacity-reservation \
    --capacity-reservation-id cr-1234abcd56EXAMPLE \
    --instance-count 5

Вывод:

{
    "Return": true
}

Дополнительную информацию см. в разделе Изменение резерва емкости в руководстве пользователя Amazon EC2.

Пример 2: Изменение даты и времени окончания существующего резерва емкости

Следующий modify-capacity-reservation пример изменяет существующий резерв емкости, чтобы он закончился в указанную дату и время.

aws ec2 modify-capacity-reservation \
    --capacity-reservation-id cr-1234abcd56EXAMPLE \
    --end-date-type limited \
    --end-date 2019-08-31T23:59:59Z

Дополнительную информацию см. в разделе Изменение резерва емкости в руководстве пользователя Amazon EC2.

Вывод

Возврат -> (булево)