Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

create-player-sessions

Описание

Зарезервирует свободные слоты в игровой сессии для группы игроков. Новые игровые сессии могут быть созданы в любой игровой сессии со свободным слотом, который находится в состоянии ACTIVE и имеет политику создания игроков ACCEPT_ALL . Для добавления одного игрока в игровую сессию используйте CreatePlayerSession

Для создания игровых сессий укажите идентификатор игровой сессии и список идентификаторов игроков. Дополнительно можно указать набор данных о каждом игроке по идентификатору.

В случае успеха, для каждого игрока зарезервируется слот в игровой сессии, и будут возвращены новые объекты PlayerSession с идентификаторами игровых сессий. Каждый игрок ссылается на свой идентификатор игровой сессии при отправке запроса подключения к игровой сессии, и игровой сервер может использовать его для проверки резервирования игрока с помощью сервиса Amazon GameLift. Игровые сессии не могут быть обновлены.

Максимальное количество игроков в одной игровой сессии составляет 200. Это значение не настраивается.

Связанные действия

Все API по задачам

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

Синтаксис

  create-player-sessions
--game-session-id <value>
--player-ids <value>
[--player-data-map <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 (строка)

Уникальный идентификатор игровой сессии, для добавления игроков.

--player-ids (список)

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

(строка)

Синтаксис:

"string" "string" ...

--player-data-map (словарь)

Словарь пар строк, каждая из которых указывает идентификатор игрока и набор данных, определённых разработчиком, относящихся к игроку. Amazon GameLift не использует эти данные, поэтому их можно форматировать по мере необходимости для использования в игре. Любые данные о игроке для идентификаторов игроков, которые не включены в параметр PlayerIds, игнорируются.

ключ -> (строка)

значение -> (строка)

Сокращённый синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--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
  • таблица
  • 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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, 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.

Вывод

PlayerSessions -> (список)

Коллекция объектов игровой сессии, созданных для добавленных игроков.

(структура)

Представляет игровую сессию. Игровые сессии создаются либо для конкретной игровой сессии, либо как часть запроса размещения или подбора игровых сессий. Игровая сессия может представлять зарезервированный игровой слот в игровой сессии (когда статус RESERVED ) или фактическую игровую активность игрока в игровой сессии (когда статус ACTIVE ). Объект игровой сессии, включая данные игрока, автоматически передаётся в игровую сессию, когда игрок подключается к игровой сессии и проходит проверку. После завершения игровой сессии информация о игровых сессиях хранится в течение 30 дней, а затем удаляется.

Связанные действия

Все API по задачам

PlayerSessionId -> (строка)

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

PlayerId -> (строка)

Уникальный идентификатор игрока, связанный с этой игровой сессией.

GameSessionId -> (строка)

Уникальный идентификатор игровой сессии, к которой подключена игровая сессия.

FleetId -> (строка)

Уникальный идентификатор флота, на котором работает игровая сессия игрока.

FleetArn -> (строка)

Amazon Resource Name (ARN) связанный с флотом GameLift, на котором запущена игровая сессия игрока.

CreationTime -> (отметка времени)

Отметка времени, показывающая, когда был создан этот объект данных. Формат — число, выраженное в формате Unix как миллисекунды (например, "1469498468.057" ).

TerminationTime -> (отметка времени)

Отметка времени, показывающая, когда был завершен этот объект данных. Формат — число, выраженное в формате Unix как миллисекунды (например, "1469498468.057" ).

Status -> (строка)

Текущий статус игровой сессии.

Возможные статусы игровой сессии:

  • RESERVED – Запрос на игровой сессии получен, но игрок ещё не подключился к процессу сервера и/или не был проверен.
  • ACTIVE – Игрок был проверен процессом сервера и в настоящее время подключен.
  • COMPLETED – Подключение игрока было разорвано.
  • TIMEDOUT – Запрос на игровой сессии был получен, но игрок не подключился и/или не был проверен в течение ограничения таймаута (60 секунд).

IpAddress -> (строка)

IP-адрес игровой сессии. Для подключения к игровому серверу Amazon GameLift приложению необходим как IP-адрес, так и номер порта.

DnsName -> (строка)

Идентификатор DNS, назначенный экземпляру, на котором работает игровая сессия. Значения имеют следующий формат:

  • Флоты с поддержкой TLS: <unique identifier>.<region identifier>.amazongamelift.com.
  • Флоты без поддержки TLS: ec2-<unique identifier>.compute.amazonaws.com. (См. Amazon EC2 Instance IP Addressing).

При подключении к игровой сессии, работающей на флоте с поддержкой TLS, необходимо использовать имя DNS, а не IP-адрес.

Port -> (целое число)

Номер порта для игровой сессии. Для подключения к процессу сервера Amazon GameLift приложению необходим как IP-адрес, так и номер порта.

PlayerData -> (строка)

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

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

Spec-Zone.ru

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