claim-game-server

Описание

Определяет доступный игровой сервер и временно резервирует его для размещения игрового процесса и игроков. Эта операция вызывается из игрового клиента или клиентской службы (например, системы подбора игроков) для запроса ресурсов размещения для новой игровой сессии. В ответ Amazon GameLift FleetIQ находит доступный игровой сервер, устанавливает его в статус CLAIMED на 60 секунд и возвращает информацию о подключении, которую игроки могут использовать для подключения к игровому серверу.

Для резервирования игрового сервера необходимо указать группу игровых серверов. Также можно указать идентификатор игрового сервера, хотя этот подход обходит оптимизацию размещения Amazon GameLift FleetIQ. Дополнительно можно включить игровые данные для передачи игровому серверу в начале игровой сессии, такие как карта игры или информация об игроках. Добавьте параметры фильтрации, чтобы дополнительно сузить выбор игрового сервера, например, разрешив резервирование только на серверах, запущенных на экземплярах типа ACTIVE.

При успешном резервировании игрового сервера возвращается информация о подключении. Статус использования зарезервированного игрового сервера остается AVAILABLE, пока статус резервирования установлен в CLAIMED в течение 60 секунд. Этот период времени дает игровому серверу время для обновления его статуса на UTILIZED после подключения игроков. Если статус игрового сервера не обновится в течение 60 секунд, игровой сервер вернется в незарезервированное состояние и станет доступен для резервирования другим запросом. Период резервирования является фиксированной величиной и не настраивается.

Если вы пытаетесь зарезервировать определенный игровой сервер, этот запрос завершится неудачей в следующих случаях:

• Если статус использования игрового сервера UTILIZED.
• Если статус резервирования игрового сервера CLAIMED.
• Если игровой сервер работает на экземпляре в состоянии DRAINING, а предоставленный параметр фильтрации не разрешает размещение на экземплярах типа DRAINING.

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

Краткое описание

  claim-game-server
--game-server-group-name <value>
[--game-server-id <value>]
[--game-server-data <value>]
[--filter-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 (строка)

--game-server-id (строка)

--game-server-data (строка)

--filter-option (структура)

Короткая синтаксическая запись:

InstanceStatuses=string,string

Синтаксис JSON:

{
  "InstanceStatuses": ["ACTIVE"|"DRAINING", ...]
}

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

Вывод

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