update-game-server-group
Описание
Обновляет свойства, специфичные для Amazon GameLift FleetIQ, для группы игровых серверов. Многие свойства группы Auto Scaling обновляются непосредственно в группе Auto Scaling, включая шаблон запуска, политики Auto Scaling и максимальное/минимальное/желаемое количество экземпляров.
Для обновления группы игровых серверов укажите ID группы игровых серверов и предоставьте обновленные значения. Перед применением обновлений новые значения проверяются, чтобы гарантировать, что Amazon GameLift FleetIQ может продолжать выполнять балансировку экземпляров. При успешном выполнении возвращается объект GameServerGroup.
Узнать больше
Руководство по Amazon GameLift FleetIQ
См. также: Документация API AWS
Синтаксис
update-game-server-group
--game-server-group-name <value>
[--role-arn <value>]
[--instance-definitions <value>]
[--game-server-protection-policy <value>]
[--balancing-strategy <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]
Параметры
--game-server-group-name (строка)
--role-arn (строка)
--instance-definitions (список)
Обновленный список типов экземпляров Amazon EC2, которые будут использоваться в группе Auto Scaling. Определения экземпляров должны указывать как минимум два разных типа экземпляров, поддерживаемых Amazon GameLift FleetIQ. Этот обновлённый список заменяет весь текущий список определений экземпляров для группы игровых серверов. Дополнительную информацию о типах экземпляров см. в разделе Типы экземпляров EC2 в руководстве пользователя Amazon EC2. Вы можете дополнительно указать весовое значение ёмкости для каждого типа экземпляра. Если для типа экземпляра не указано значение веса, оно устанавливается по умолчанию равным “1”. Дополнительную информацию о весовом значении ёмкости см. в руководстве пользователя Amazon EC2 Auto Scaling.
(структура)
Разрешённый тип экземпляра для группы игровых серверов. Все группы игровых серверов должны иметь как минимум два определённых типа экземпляров. Amazon GameLift FleetIQ периодически оценивает каждый определённый тип экземпляра на предмет пригодности. Затем он обновляет группу Auto Scaling с перечнем пригодных типов экземпляров.
InstanceType -> (строка)
WeightedCapacity -> (строка)
Сокращенный синтаксис:
InstanceType=string,WeightedCapacity=string ...
Синтаксис JSON:
[
{
"InstanceType": "c4.large"|"c4.xlarge"|"c4.2xlarge"|"c4.4xlarge"|"c4.8xlarge"|"c5.large"|"c5.xlarge"|"c5.2xlarge"|"c5.4xlarge"|"c5.9xlarge"|"c5.12xlarge"|"c5.18xlarge"|"c5.24xlarge"|"c5a.large"|"c5a.xlarge"|"c5a.2xlarge"|"c5a.4xlarge"|"c5a.8xlarge"|"c5a.12xlarge"|"c5a.16xlarge"|"c5a.24xlarge"|"c6g.medium"|"c6g.large"|"c6g.xlarge"|"c6g.2xlarge"|"c6g.4xlarge"|"c6g.8xlarge"|"c6g.12xlarge"|"c6g.16xlarge"|"r4.large"|"r4.xlarge"|"r4.2xlarge"|"r4.4xlarge"|"r4.8xlarge"|"r4.16xlarge"|"r5.large"|"r5.xlarge"|"r5.2xlarge"|"r5.4xlarge"|"r5.8xlarge"|"r5.12xlarge"|"r5.16xlarge"|"r5.24xlarge"|"r5a.large"|"r5a.xlarge"|"r5a.2xlarge"|"r5a.4xlarge"|"r5a.8xlarge"|"r5a.12xlarge"|"r5a.16xlarge"|"r5a.24xlarge"|"r6g.medium"|"r6g.large"|"r6g.xlarge"|"r6g.2xlarge"|"r6g.4xlarge"|"r6g.8xlarge"|"r6g.12xlarge"|"r6g.16xlarge"|"m4.large"|"m4.xlarge"|"m4.2xlarge"|"m4.4xlarge"|"m4.10xlarge"|"m5.large"|"m5.xlarge"|"m5.2xlarge"|"m5.4xlarge"|"m5.8xlarge"|"m5.12xlarge"|"m5.16xlarge"|"m5.24xlarge"|"m5a.large"|"m5a.xlarge"|"m5a.2xlarge"|"m5a.4xlarge"|"m5a.8xlarge"|"m5a.12xlarge"|"m5a.16xlarge"|"m5a.24xlarge"|"m6g.medium"|"m6g.large"|"m6g.xlarge"|"m6g.2xlarge"|"m6g.4xlarge"|"m6g.8xlarge"|"m6g.12xlarge"|"m6g.16xlarge",
"WeightedCapacity": "string"
}
...
]
--game-server-protection-policy (строка)
Флаг, указывающий, защищены ли экземпляры в группе игровых серверов от преждевременного завершения. Незащищённые экземпляры, на которых выполняются активные игровые серверы, могут быть завершены во время события масштабирования вниз, что приведёт к выходу игроков из игры. Защищённые экземпляры не могут быть завершены, пока на них выполняются активные игровые серверы, за исключением случая принудительного удаления группы игровых серверов (см. ). Исключением из этого правила являются Spot-экземпляры, которые могут быть завершены Amazon Web Services независимо от статуса защиты. Данное свойство устанавливается по умолчанию в NO_PROTECTION.
Возможные значения:
NO_PROTECTIONFULL_PROTECTION
--balancing-strategy (строка)
Указывает, как Amazon GameLift FleetIQ балансирует использование Spot-экземпляров и экземпляров On-Demand в группе игровых серверов. Варианты методов включают:
-
SPOT_ONLY- В группе игровых серверов используются только Spot-экземпляры. Если Spot-экземпляры недоступны или непригодны для размещения игр, группа игровых серверов не предоставляет возможности размещения, пока Spot-экземпляры снова не станут доступными. До тех пор новые экземпляры не запускаются, а существующие непригодные Spot-экземпляры завершаются (после завершения текущей игры) и не заменяются. -
SPOT_PREFERRED- (значение по умолчанию) Spot-экземпляры используются всякий раз, когда они доступны в группе игровых серверов. Если Spot-экземпляры недоступны, группа игровых серверов продолжает обеспечивать возможности размещения, переходя к экземплярам On-Demand. Существующие непригодные Spot-экземпляры завершаются (после завершения текущей игры) и заменяются новыми экземплярами On-Demand. -
ON_DEMAND_ONLY- В группе игровых серверов используются только экземпляры On-Demand. Spot-экземпляры не используются, даже если они доступны, пока эта стратегия балансировки активна.
Возможные значения:
SPOT_ONLYSPOT_PREFERREDON_DEMAND_ONLY
--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.
Вывод
GameServerGroup -> (структура)
Объект, описывающий ресурс группы серверов игры с обновлёнными свойствами.
GameServerGroupName -> (строка)
GameServerGroupArn -> (строка)
RoleArn -> (строка)
InstanceDefinitions -> (список)
Набор типов экземпляров Amazon EC2, которые Amazon GameLift FleetIQ может использовать при балансировке и автоматическом масштабировании экземпляров в соответствующей группе автоматического масштабирования.
(структура)
Разрешённый тип экземпляра для группы серверов игры. Все группы серверов игры должны иметь как минимум два определённых типа экземпляров. Amazon GameLift FleetIQ периодически оценивает каждый определённый тип экземпляра на жизнеспособность. Затем он обновляет группу автоматического масштабирования списком жизнеспособных типов экземпляров.
InstanceType -> (строка)
WeightedCapacity -> (строка)
BalancingStrategy -> (строка)
Указывает, как Amazon GameLift FleetIQ балансирует использование экземпляров Spot и On-Demand в группе серверов игры. Методы включают:
-
SPOT_ONLY- В группе серверов игры используются только экземпляры Spot. Если экземпляры Spot недоступны или не подходят для размещения игры, группа серверов игры не предоставляет ёмкость для размещения, пока экземпляры Spot снова не станут доступны. До этого момента новые экземпляры не запускаются, а существующие неподходящие экземпляры Spot завершаются (после окончания текущей игры) и не заменяются. -
SPOT_PREFERRED- (значение по умолчанию) Экземпляры Spot используются, когда доступны в группе серверов игры. Если экземпляры Spot недоступны, группа серверов игры продолжает предоставлять ёмкость для размещения, переходя к экземплярам On-Demand. Существующие неподходящие экземпляры Spot завершаются (после окончания текущей игры) и заменяются новыми экземплярами On-Demand. -
ON_DEMAND_ONLY- В группе серверов игры используются только экземпляры On-Demand. Экземпляры Spot не используются, даже если они доступны, пока активна эта стратегия балансировки.
GameServerProtectionPolicy -> (строка)
AutoScalingGroupArn -> (строка)
Status -> (строка)
Текущий статус группы серверов игры. Возможные статусы:
-
NEW- Amazon GameLift FleetIQ проверил запросCreateGameServerGroup(). -
ACTIVATING- Amazon GameLift FleetIQ настраивает группу серверов игры, что включает создание группы автоматического масштабирования в вашей учётной записи Amazon Web Services. -
ACTIVE- Группа серверов игры успешно создана. -
DELETE_SCHEDULED- Получен запрос на удаление группы серверов игры. -
DELETING- Amazon GameLift FleetIQ получил действительный запросDeleteGameServerGroup()и обрабатывает его. Amazon GameLift FleetIQ должен сначала завершить и освободить хосты, прежде чем удалить группу автоматического масштабирования и группу серверов игры. -
DELETED- Группа серверов игры успешно удалена. -
ERROR- Асинхронные процессы активации или удаления группы серверов игры завершились ошибкой, что привело к состоянию ошибки.
StatusReason -> (строка)
ERROR.SuspendedActions -> (список)
Список задач, временно приостановленных для этой группы серверов игры. Если это свойство пустое, все задачи выполняются.
(строка)
CreationTime -> (метка времени)
"1469498468.057").LastUpdatedTime -> (метка времени)
© Copyright 2025, Amazon Web Services. Created using Sphinx.