обновить-емкость-флота

Описание

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

Используйте эту операцию для установки следующих свойств емкости флота:

• Минимальный/максимальный размер: Устанавливает жёсткие ограничения на количество экземпляров Amazon EC2, разрешённых для использования. Если Amazon GameLift получает запрос — как через ручное обновление, так и через автоматическое масштабирование — он не изменит емкость до значения, выходящего за пределы этого диапазона.
• Желаемая емкость: В качестве альтернативы автоматическому масштабированию вручную задайте количество экземпляров Amazon EC2, которые должны поддерживаться. Прежде чем изменять желаемую емкость флота, проверьте максимальную емкость типа экземпляра Amazon EC2, вызвав DescribeEC2InstanceLimits.

Чтобы обновить емкость для домашнего региона флота или если у флота нет удалённых расположений, опустите параметр Location. Флот должен находиться в состоянии ACTIVE.

Чтобы обновить емкость для удалённого расположения флота, установите параметр Location на расположение для обновления. Расположение должно находиться в состоянии ACTIVE.

В случае успеха Amazon GameLift обновляет настройки емкости и возвращает идентификаторы обновлённого флота и/или расположения. Если запрошенное изменение желаемой емкости превышает предел типа экземпляра, возникает исключение LimitExceeded.

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

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

Синтаксис

  update-fleet-capacity
--fleet-id <value>
[--desired-instances <value>]
[--min-size <value>]
[--max-size <value>]
[--location <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]

Параметры

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

--desired-instances (целое число)

--min-size (целое число)

--max-size (целое число)

--location (строка)

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

Вывод

FleetId -> (строка)

FleetArn -> (строка)

Location -> (строка)