terminate-game-session

Описание

Завершает игровой сеанс, который в данный момент активен. Используйте эту операцию для завершения любого игрового сеанса, который не находится в состоянии ERROR. Завершение игрового сеанса — наиболее эффективный способ освободить процесс сервера, когда он размещает игровой сеанс, находящийся в плохом состоянии или не завершающийся должным образом. Вы можете использовать эту операцию для завершения игрового сеанса, который размещается на любом типе вычислительных ресурсов Amazon GameLift, включая вычислительные ресурсы для управляемых EC2, управляемых контейнеров и флот-вычислительных ресурсов Anywhere. Серверная игра должна быть интегрирована с серверным SDK Amazon GameLift 5.x или более поздней версии.

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

• Инициировать плавное завершение, используя стандартную последовательность завершения игрового сеанса. В этом режиме сервис Amazon GameLift запрашивает у процесса сервера, размещающего игровой сеанс, вызвав метод обратного вызова серверного SDK OnProcessTerminate(). Реализация обратного вызова является частью пользовательского кода серверной игры. Она может включать в себя различные действия для плавного завершения игрового сеанса, такие как уведомление игроков, прежде чем остановить процесс сервера.
• Вызвать немедленное завершение игрового сеанса. В этом режиме сервис Amazon GameLift принимает меры для остановки процесса сервера, что завершает игровой сеанс без стандартной последовательности завершения игрового сеанса.

При успешном выполнении инициируется завершение игрового сеанса. В ходе этой операции статус игрового сеанса изменяется на TERMINATING. После завершения процесс сервера, который размещал игровой сеанс, был остановлен и заменён новым процессом сервера, готовым к размещению нового игрового сеанса. Статус старого игрового сеанса изменяется на TERMINATED со значением причины, указывающей используемый метод завершения.

Справочник по серверному SDK Amazon GameLift 5 для OnProcessTerminate() (C++ ) (C# ) (Unreal ) (Go )

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

Синопсис

  terminate-game-session
--game-session-id <value>
--termination-mode <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-session-id (строка)

--termination-mode (строка)

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

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

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

--color (строка)

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

• on
• off
• auto

--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.

Вывод

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