Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

update-matchmaking-configuration

Описание

Обновляет настройки конфигурации подбора игроков FlexMatch. Эти изменения влияют на все матчи и игровые сессии, созданные после обновления. Для обновления настроек укажите имя конфигурации для обновления и предоставьте новые настройки.

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

Разработка подборщика FlexMatch

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

Синтаксис

  update-matchmaking-configuration
--name <value>
[--description <value>]
[--game-session-queue-arns <value>]
[--request-timeout-seconds <value>]
[--acceptance-timeout-seconds <value>]
[--acceptance-required | --no-acceptance-required]
[--rule-set-name <value>]
[--notification-target <value>]
[--additional-player-count <value>]
[--custom-event-data <value>]
[--game-properties <value>]
[--game-session-data <value>]
[--backfill-mode <value>]
[--flex-match-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]

Параметры

--name (строка)

Уникальный идентификатор конфигурации подбора игроков для обновления. Можно использовать имя конфигурации или значение ARN.

--description (строка)

Описание конфигурации подбора игроков.

--game-session-queue-arns (список)

Amazon Resource Name (ARN) , назначенный ресурсу очереди игровых сессий Amazon GameLift и уникально его идентифицирующий. ARN уникальны в каждом регионе. Формат: arn:aws:gamelift:<region>::gamesessionqueue/<queue name> . Очереди могут находиться в любом регионе. Очереди используются для запуска новых игровых сессий Amazon GameLift для матчей, созданных с помощью этой конфигурации подбора игроков. Если FlexMatchMode установлено в значение STANDALONE, не устанавливайте этот параметр.

(строка)

Синтаксис:

"string" "string" ...

--request-timeout-seconds (целое число)

Максимальная продолжительность (в секундах), в течение которой билет подбора игроков может обрабатываться, прежде чем истечёт время ожидания. Запросы, которые завершились из-за истечения времени ожидания, можно повторно отправить по мере необходимости.

--acceptance-timeout-seconds (целое число)

Время ожидания (в секундах), в течение которого игроки должны принять предложенный матч, если требуется принятие.

--acceptance-required | --no-acceptance-required (логическое значение)

Флаг, указывающий, требуется ли принятие матча, созданного с помощью этой конфигурации, со стороны соответствующих игроков. Для требования принятия установите значение TRUE. При включенном этом параметре билеты подбора игроков используют состояние REQUIRES_ACCEPTANCE, чтобы указать, когда завершённый потенциальный матч ожидает принятия игроками.

--rule-set-name (строка)

Уникальный идентификатор набора правил подбора игроков для использования с этой конфигурацией. Можно использовать имя набора правил или значение ARN. Конфигурация подбора игроков может использовать только наборы правил, определённые в одном регионе.

--notification-target (строка)

ARN темы SNS, настроенной для получения уведомлений о подборе игроков. См. Настройка уведомлений для подбора игроков для получения дополнительной информации.

--additional-player-count (целое число)

Количество игровых слотов в матче, которые необходимо оставить открытыми для будущих игроков. Например, если набор правил конфигурации задаёт матч для одной команды из 12 человек, а количество дополнительных игроков установлено в 2, то для матча будут выбраны только 10 игроков. Этот параметр не используется, если FlexMatchMode установлено в STANDALONE .

--custom-event-data (строка)

Информация для добавления ко всем событиям, относящимся к конфигурации подбора игроков.

--game-properties (список)

Набор пар ключ-значение, которые могут хранить пользовательские данные в игровой сессии. Например: {"Key": "difficulty", "Value": "novice"} . Эта информация добавляется к новому объекту GameSession, созданному для успешного матча. Этот параметр не используется, если FlexMatchMode установлено в STANDALONE .

(структура)

Эта пара ключ-значение может хранить пользовательские данные об игровой сессии. Например, можно использовать GameProperty для отслеживания карты игровой сессии, уровня сложности или оставшегося времени. Уровень сложности можно указать так: {"Key": "difficulty", "Value":"Novice"} .

Можно устанавливать свойства игры при создании игровой сессии. Также можно изменять свойства игры активной игровой сессии. При поиске игровых сессий можно фильтровать по ключам и значениям свойств игры. Удалить свойства игры из игровой сессии нельзя.

Примеры работы со свойствами игры см. в разделе Создание игровой сессии со свойствами .

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

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

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

Значение свойства игры.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

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

Набор пользовательских свойств игровой сессии, отформатированных как единственное строковое значение. Эти данные передаются в процесс сервера игры с запросом на запуск новой игровой сессии. Для получения дополнительной информации см. Запуск игровой сессии . Эта информация добавляется к игровой сессии, созданной для успешного матча. Этот параметр не используется, если FlexMatchMode установлено в STANDALONE .

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

Метод, используемый для заполнения игровых сессий, созданных с помощью этой конфигурации подбора игроков. Укажите MANUAL, если игра управляет запросами на заполнение вручную или не использует функцию заполнения матча. Укажите AUTOMATIC, чтобы GameLift создавал запрос на заполнение матча, когда игровая сессия имеет один или несколько открытых слотов. Подробнее о ручном и автоматическом заполнении см. в разделе Заполнение существующих игр с помощью FlexMatch . Автоматическое заполнение недоступно, если FlexMatchMode установлено в STANDALONE .

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

  • AUTOMATIC
  • MANUAL

--flex-match-mode (строка)

Указывает, используется ли эта конфигурация подбора игроков с Amazon GameLift или как самостоятельное решение для подбора игроков.

  • STANDALONE - FlexMatch формирует матчи и возвращает информацию о матче, включая игроков и распределение по командам, в событии MatchmakingSucceeded.
  • WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска игровой сессии для матча.

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

  • STANDALONE
  • WITH_QUEUE

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

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

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

Отключить автоматическое запрошение параметров командной строки.

Вывод

Конфигурация -> (структура)

Обновленная конфигурация подбора.

Имя -> (строка)

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

ConfigurationArn -> (строка)

Amazon Resource Name (ARN), присвоенный ресурсу Amazon GameLift конфигурации подбора и уникально его идентифицирующий. ARNs уникальны во всех регионах. Формат arn:aws:gamelift:<region>::matchmakingconfiguration/<matchmaking configuration name> . В ARN конфигурации Amazon GameLift идентификатор ресурса соответствует значению Имя.

Описание -> (строка)

Дескриптивное описание, связанное с конфигурацией подбора.

GameSessionQueueArns -> (список)

Amazon Resource Name (ARN), присвоенный ресурсу очереди сессий Amazon GameLift и уникально его идентифицирующий. ARNs уникальны во всех регионах. Формат arn:aws:gamelift:<region>::gamesessionqueue/<queue name> . Очереди могут находиться в любом регионе. Очереди используются для запуска новых сессий игр Amazon GameLift для матчей, созданных с этой конфигурацией подбора. Это свойство не задается, когда FlexMatchMode установлено в STANDALONE .

(строка)

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

Максимальная продолжительность (в секундах), в течение которой билет подбора может оставаться в процессе обработки перед истечением времени ожидания. Запросы, завершившиеся по причине истечения времени ожидания, могут быть повторно отправлены по мере необходимости.

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

Время (в секундах), в течение которого ожидается, что игроки примут предложенный матч, если требуется принятие. Если какой-либо игрок отклоняет матч или не принимает его до истечения срока ожидания, билет продолжает поиск подходящего матча.

AcceptanceRequired -> (логическое значение)

Флаг, указывающий, требуется ли принятие матча, созданного с этой конфигурацией, со стороны игроков. Для требования принятия установите значение TRUE. Когда эта опция включена, билеты подбора используют статус REQUIRES_ACCEPTANCE для обозначения завершенного потенциального матча, ожидающего принятия игроками.

RuleSetName -> (строка)

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

RuleSetArn -> (строка)

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

NotificationTarget -> (строка)

ARN темы SNS, настроенной для получения уведомлений о подборе.

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

Количество слотов для игроков в матче, которые необходимо оставить открытыми для будущих игроков. Например, если набор правил конфигурации определяет матч для одной команды из 12 человек, а дополнительное количество игроков установлено в 2, только 10 игроков выбираются для матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE .

CustomEventData -> (строка)

Информация, которая прикрепляется ко всем событиям, связанным с конфигурацией подбора.

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

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

GameProperties -> (список)

Набор пар ключ-значение, которые могут хранить пользовательские данные в сессии игры. Например: {"Key": "difficulty", "Value": "novice"} . Эта информация добавляется к новому объекту GameSession, который создается для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE .

(структура)

Эта пара ключ-значение может хранить пользовательские данные о сессии игры. Например, вы можете использовать GameProperty для отслеживания карты сессии игры, уровня сложности или оставшегося времени. Уровень сложности можно указать так: {"Key": "difficulty", "Value":"Novice"} .

Вы можете задать свойства игры при создании сессии игры. Вы также можете изменить свойства игры активной сессии игры. При поиске сессий игр вы можете фильтровать по ключам и значениям свойств игры. Вы не можете удалить свойства игры из сессии игры.

Примеры работы со свойствами игры см. в Create a game session with properties.

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

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

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

Значение свойства игры.

GameSessionData -> (строка)

Набор пользовательских свойств сессии игры, отформатированных как одно строковое значение. Эти данные передаются процессу сервера игры с запросом на запуск новой сессии игры. Дополнительную информацию см. в разделе Start a game session . Эта информация добавляется к новому объекту GameSession, который создается для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE .

BackfillMode -> (строка)

Метод, используемый для добавления сессий игр, созданных с этой конфигурацией подбора. MANUAL указывает, что игра создает запросы на добавление или не использует функцию добавления матчей. AUTOMATIC указывает, что GameLift создает запросы на добавление всякий раз, когда сессия игры имеет один или несколько открытых слотов. Подробнее о ручном и автоматическом добавлении см. в разделе Backfill existing games with FlexMatch . Автоматическое добавление недоступно, когда FlexMatchMode установлено в STANDALONE .

FlexMatchMode -> (строка)

Указывает, используется ли эта конфигурация подбора с хостингом Amazon GameLift или как автономное решение для подбора.

  • STANDALONE - FlexMatch формирует матчи и возвращает информацию о матче, включая игроков и назначение команд, в событии MatchmakingSucceeded.
  • WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска сессии игры для матча.

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

Spec-Zone.ru

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