Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

Возобновить-группу-серверов-игр

Описание

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

Восстанавливает активность группы серверов игр после её приостановки. Группа серверов игр может быть приостановлена операцией SuspendGameServerGroup или приостановлена непреднамеренно из-за проблемы с конфигурацией. В последнем случае вы можете вручную возобновить работу группы после решения проблемы с конфигурацией. Дополнительную информацию о причинах приостановки активности группы см. в статусе и причине статуса группы серверов игр.

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

Дополнительная информация

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

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

Синтаксис

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

--resume-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-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запросы параметров ввода CLI.

Вывод

GameServerGroup -> (структура)

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

GameServerGroupName -> (строка)

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

GameServerGroupArn -> (строка)

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

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

Сгенерированный уникальный ID для группы 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 time в миллисекундах (например, "1469498468.057").

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

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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