Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

suspend-game-server-group

Описание

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

Временно останавливает работу группы игровых серверов без завершения экземпляров или самой группы. Вы можете возобновить работу, вызвав ResumeGameServerGroup . Вы можете приостановить следующие действия:

  • Замена типа экземпляра - Это действие оценивает текущую жизнеспособность размещения игрового хостинга для всех типов Spot-экземпляров, которые определены для группы игровых серверов. Оно обновляет группу Auto Scaling, удаляя нежизнеспособные типы Spot-экземпляров, которые имеют большую вероятность прерываний игровых серверов. Затем оно балансирует емкость по оставшимся жизнеспособным типам Spot-экземпляров. При приостановке этого действия группа Auto Scaling продолжает работать с текущим балансом, независимо от жизнеспособности. Действия по защите экземпляров, метрики использования и масштабированию емкости остаются активными.

Для приостановки действия укажите ARN группы игровых серверов и тип приостанавливаемого действия. При успешном выполнении возвращается объект GameServerGroup, показывающий, что это действие указано в SuspendedActions.

Дополнительные сведения

Руководство Amazon GameLift FleetIQ

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

Синтаксис

  suspend-game-server-group
--game-server-group-name <value>
--suspend-actions <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.

--suspend-actions (список)

Действие, которое нужно приостановить для этой группы игровых серверов.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  REPLACE_INSTANCE_TYPES

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

Объект, описывающий ресурс группы серверов игры, с обновлённым свойством SuspendedActions, отражающим приостановленную активность.

GameServerGroupName -> (строка)

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

GameServerGroupArn -> (строка)

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

RoleArn -> (строка)

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

InstanceDefinitions -> (список)

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

(структура)

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

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

InstanceType -> (строка)

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

WeightedCapacity -> (строка)

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

BalancingStrategy -> (строка)

Указывает, как Amazon GameLift FleetIQ балансирует использование Spot Instances и On-Demand Instances в группе серверов игры. Доступные варианты включают:

  • SPOT_ONLY — В группе серверов игры используются только Spot Instances. Если Spot Instances недоступны или непригодны для размещения игр, группа серверов игры не предоставляет ёмкость для размещения, пока Spot Instances снова не станут доступными. До тех пор новые экземпляры не запускаются, а существующие непригодные Spot Instances завершаются (после завершения текущей игры) и не заменяются.
  • SPOT_PREFERRED — (значение по умолчанию) Spot Instances используются всякий раз, когда они доступны в группе серверов игры. Если Spot Instances недоступны, группа серверов игры продолжает предоставлять ёмкость для размещения, переключаясь на On-Demand Instances. Существующие непригодные Spot Instances завершаются (после завершения текущей игры) и заменяются новыми On-Demand Instances.
  • ON_DEMAND_ONLY — В группе серверов игры используются только On-Demand Instances. Spot Instances не используются, даже если они доступны, пока действует эта стратегия балансировки.

GameServerProtectionPolicy -> (строка)

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

AutoScalingGroupArn -> (строка)

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

Status -> (строка)

Текущий статус группы серверов игры. Возможные статусы:

  • NEW — Amazon GameLift FleetIQ проверил запрос CreateGameServerGroup().
  • ACTIVATING — Amazon GameLift FleetIQ настраивает группу серверов игры, включая создание группы Auto Scaling в вашей учётной записи Amazon Web Services.
  • ACTIVE — Группа серверов игры успешно создана.
  • DELETE_SCHEDULED — Получен запрос на удаление группы серверов игры.
  • DELETING — Amazon GameLift FleetIQ получил действительный запрос DeleteGameServerGroup() и обрабатывает его. Amazon GameLift FleetIQ должен сначала завершить и освободить хосты, прежде чем удалить группу Auto Scaling и группу серверов игры.
  • 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