Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

update-game-server-group

Описание

Данная операция используется с решением Amazon GameLift FleetIQ и группами игровых серверов.

Обновляет свойства, специфичные для 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 (строка)

Уникальный идентификатор группы игровых серверов. Используйте имя или значение ARN.

--role-arn (строка)

Amazon Resource Name (ARN) для роли IAM, которая позволяет Amazon GameLift получать доступ к вашим группам Amazon EC2 Auto Scaling.

--instance-definitions (список)

Обновленный список типов экземпляров Amazon EC2, которые будут использоваться в группе Auto Scaling. Определения экземпляров должны указывать как минимум два разных типа экземпляров, поддерживаемых Amazon GameLift FleetIQ. Этот обновлённый список заменяет весь текущий список определений экземпляров для группы игровых серверов. Дополнительную информацию о типах экземпляров см. в разделе Типы экземпляров EC2 в руководстве пользователя Amazon EC2. Вы можете дополнительно указать весовое значение ёмкости для каждого типа экземпляра. Если для типа экземпляра не указано значение веса, оно устанавливается по умолчанию равным “1”. Дополнительную информацию о весовом значении ёмкости см. в руководстве пользователя Amazon EC2 Auto Scaling.

(структура)

Этот тип данных используется с Amazon GameLift FleetIQ и группами игровых серверов.

Разрешённый тип экземпляра для группы игровых серверов. Все группы игровых серверов должны иметь как минимум два определённых типа экземпляров. Amazon GameLift FleetIQ периодически оценивает каждый определённый тип экземпляра на предмет пригодности. Затем он обновляет группу Auto Scaling с перечнем пригодных типов экземпляров.

InstanceType -> (строка)

Обозначение типа экземпляра Amazon EC2.

WeightedCapacity -> (строка)

Весовое значение ёмкости, которое указывает, насколько данный тип экземпляра способствует общей ёмкости группы игровых серверов. Веса экземпляров используются Amazon GameLift FleetIQ для расчёта стоимости экземпляра за час и лучшего определения наиболее выгодных вариантов. Дополнительную информацию о весовом значении ёмкости экземпляров см. в руководстве пользователя Amazon Elastic Compute Cloud Auto Scaling. Значение по умолчанию равно “1”.

Сокращенный синтаксис:

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_PROTECTION
  • FULL_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_ONLY
  • SPOT_PREFERRED
  • ON_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 -> (строка)

Определяемый разработчиком идентификатор группы серверов игры. Название уникально для каждой области в каждой учётной записи Amazon Web Services.

GameServerGroupArn -> (строка)

Сгенерированный уникальный идентификатор группы серверов игры.

RoleArn -> (строка)

Идентификатор ресурса Amazon (ARN) роли IAM, разрешающей Amazon GameLift получать доступ к группам автоматического масштабирования Amazon EC2.

InstanceDefinitions -> (список)

Набор типов экземпляров Amazon EC2, которые Amazon GameLift FleetIQ может использовать при балансировке и автоматическом масштабировании экземпляров в соответствующей группе автоматического масштабирования.

(структура)

Этот тип данных используется с Amazon GameLift FleetIQ и группами серверов игры.

Разрешённый тип экземпляра для группы серверов игры. Все группы серверов игры должны иметь как минимум два определённых типа экземпляров. Amazon GameLift FleetIQ периодически оценивает каждый определённый тип экземпляра на жизнеспособность. Затем он обновляет группу автоматического масштабирования списком жизнеспособных типов экземпляров.

InstanceType -> (строка)

Обозначение типа экземпляра Amazon EC2.

WeightedCapacity -> (строка)

Взвешивание экземпляра, показывающее, насколько этот тип экземпляра вносит вклад в общую ёмкость группы серверов игры. Веса экземпляров используются Amazon GameLift FleetIQ для расчёта стоимости типа экземпляра за час и лучшего определения наиболее экономичных вариантов. Подробную информацию о взвешивании ёмкости экземпляров см. в руководстве пользователя Amazon Elastic Compute Cloud Auto Scaling. Значение по умолчанию — «1».

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 -> (строка)

Флаг, указывающий, защищены ли экземпляры в группе серверов игры от преждевременного завершения. Незащищённые экземпляры, на которых работают активные серверы игры, могут быть завершены во время события уменьшения масштаба, что может привести к выводу игроков из игры. Защищённые экземпляры не могут быть завершены, пока на них работают активные серверы игры, за исключением случая принудительного удаления группы серверов игры (см. ). Исключением являются экземпляры Spot, которые могут быть завершены Amazon Web Services независимо от статуса защиты.

AutoScalingGroupArn -> (строка)

Сгенерированный уникальный идентификатор группы автоматического масштабирования Amazon EC2, связанной с этой группой серверов игры.

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 -> (метка времени)

Маркер времени, указывающий, когда был создан этот объект данных. Формат — число, выраженное в миллисекундах времени Unix (например, "1469498468.057").

LastUpdatedTime -> (метка времени)

Маркер времени, указывающий, когда была обновлена последняя группа серверов игры.

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

Spec-Zone.ru

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