Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

удалить-группу-серверов-игр

Описание

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

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

  • Группа серверов игр
  • Соответствующая группа Auto Scaling
  • Все серверы игр, которые в настоящее время работают в группе

Чтобы удалить группу серверов игр, определите группу серверов игр, которую нужно удалить, и укажите тип операции удаления, которую нужно инициировать. Группы серверов игр могут быть удалены только в статусе ACTIVE или ERROR.

Если запрос на удаление успешен, запускается серия операций. Статус группы серверов игр изменяется на DELETE_SCHEDULED, что предотвращает регистрацию новых серверов игр и останавливает автоматическую масштабируемость. После того, как все серверы игр в группе серверов игр будут дерегистрированы, Amazon GameLift FleetIQ может начать удаление ресурсов. Если какая-либо из операций удаления завершится неудачно, группа серверов игр переводится в статус ERROR.

Amazon GameLift FleetIQ отправляет события удаления в Amazon CloudWatch.

Узнать больше

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

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

Синтаксис

  delete-game-server-group
--game-server-group-name <value>
[--delete-option <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.

--delete-option (строка)

Тип удаления для выполнения. Доступны следующие варианты:

  • SAFE_DELETE – (по умолчанию) Завершает работу группы серверов игр и группы Amazon EC2 Auto Scaling только тогда, когда в ней нет серверов игр, находящихся в статусе UTILIZED.
  • FORCE_DELETE – Завершает работу группы серверов игр, включая все активные серверы игр независимо от их статуса использования, и группы Amazon EC2 Auto Scaling.
  • RETAIN – Выполняет безопасное удаление группы серверов игр, но сохраняет группу Amazon EC2 Auto Scaling в неизменном виде.

Возможные значения:

  • SAFE_DELETE
  • FORCE_DELETE
  • RETAIN

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Используемый регион. Переопределяет настройки config/env.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл-пакет CA-сертификатов для использования при проверке SSL-сертификатов. Переопределяет настройки config/env.

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

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

GameServerGroupName -> (строка)

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

GameServerGroupArn -> (строка)

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

RoleArn -> (строка)

Идентификатор ресурса Amazon (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 -> (строка)

Сгенерированный уникальный идентификатор группы 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.

Spec-Zone.ru

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