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 (строка)
--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 (логическое значение)
REQUIRES_ACCEPTANCE, чтобы указать, когда завершённый потенциальный матч ожидает принятия игроками.--rule-set-name (строка)
--notification-target (строка)
--additional-player-count (целое число)
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 .
Возможные значения:
AUTOMATICMANUAL
--flex-match-mode (строка)
Указывает, используется ли эта конфигурация подбора игроков с Amazon GameLift или как самостоятельное решение для подбора игроков.
- STANDALONE - FlexMatch формирует матчи и возвращает информацию о матче, включая игроков и распределение по командам, в событии MatchmakingSucceeded.
- WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска игровой сессии для матча.
Возможные значения:
STANDALONEWITH_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 -> (строка)
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 -> (логическое значение)
REQUIRES_ACCEPTANCE для обозначения завершенного потенциального матча, ожидающего принятия игроками.RuleSetName -> (строка)
RuleSetArn -> (строка)
NotificationTarget -> (строка)
AdditionalPlayerCount -> (целое число)
FlexMatchMode установлено в STANDALONE .CustomEventData -> (строка)
CreationTime -> (отметка времени)
"1469498468.057" ).GameProperties -> (список)
Набор пар ключ-значение, которые могут хранить пользовательские данные в сессии игры. Например: {"Key": "difficulty", "Value": "novice"} . Эта информация добавляется к новому объекту GameSession, который создается для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE .
(структура)
Эта пара ключ-значение может хранить пользовательские данные о сессии игры. Например, вы можете использовать GameProperty для отслеживания карты сессии игры, уровня сложности или оставшегося времени. Уровень сложности можно указать так: {"Key": "difficulty", "Value":"Novice"} .
Вы можете задать свойства игры при создании сессии игры. Вы также можете изменить свойства игры активной сессии игры. При поиске сессий игр вы можете фильтровать по ключам и значениям свойств игры. Вы не можете удалить свойства игры из сессии игры.
Примеры работы со свойствами игры см. в Create a game session with properties.
Ключ -> (строка)
Значение -> (строка)
GameSessionData -> (строка)
GameSession, который создается для успешного матча. Этот параметр не используется, когда FlexMatchMode установлено в STANDALONE .BackfillMode -> (строка)
FlexMatchMode установлено в STANDALONE .FlexMatchMode -> (строка)
Указывает, используется ли эта конфигурация подбора с хостингом Amazon GameLift или как автономное решение для подбора.
- STANDALONE - FlexMatch формирует матчи и возвращает информацию о матче, включая игроков и назначение команд, в событии MatchmakingSucceeded.
- WITH_QUEUE - FlexMatch формирует матчи и использует указанную очередь Amazon GameLift для запуска сессии игры для матча.
© Copyright 2025, Amazon Web Services. Created using Sphinx.