create-game-session-queue

Описание

Создает очередь размещения, которая обрабатывает запросы на новые игровые сессии. Очередь использует алгоритмы FleetIQ для поиска наилучших доступных мест размещения для новой игровой сессии, а затем запрашивает процесс игрового сервера запустить новую игровую сессию.

Очередь игровой сессии настраивается с набором пунктов назначения (флотов или псевдонимов Amazon GameLift), которые определяют, где очередь может разместить новые игровые сессии. Эти пункты назначения могут охватывать несколько областей Amazon Web Services, могут использовать разные типы экземпляров и могут включать как Spot, так и On-Demand флоты. Если очередь включает флоты с несколькими местоположениями, очередь может разместить игровые сессии в любом из удаленных местоположений флота.

Вы можете настроить очередь для определения того, как она выбирает лучшее доступное место для новой игровой сессии. Очереди могут отдавать приоритет при размещении на основе сочетания местоположения, стоимости размещения и задержки игроков. Вы можете настроить очередь на использование стандартных приоритетов или предоставить альтернативные инструкции с помощью PriorityConfiguration .

Используйте эту операцию для выполнения следующих типов запросов.

• Создать очередь с минимально необходимыми параметрами.
  • Name
  • Destinations (Этот параметр не обязателен, но очередь не может выполнять размещения без хотя бы одного пункта назначения.)
• Создать очередь с уведомлениями о размещении. Очереди с высокой активностью размещения должны использовать систему уведомлений, например, с использованием Amazon Simple Notification Service (Amazon SNS) или Amazon CloudWatch.
  • Обязательные параметры Name и Destinations
  • NotificationTarget
• Создать очередь с настраиваемыми параметрами приоритезации. Эти настраиваемые параметры заменяют стандартную конфигурацию приоритетов для очереди.
  • Обязательные параметры Name и Destinations
  • PriorityConfiguration
• Создать очередь со специальными правилами для обработки данных о задержке игроков.
  • Обязательные параметры Name и Destinations
  • PlayerLatencyPolicies

При успешном выполнении этой операции возвращается новый GameSessionQueue объект с назначенным ARN очереди. Используйте имя или ARN очереди при отправке новых запросов на игровые сессии с помощью StartGameSessionPlacement или StartMatchmaking .

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

Синтаксис

  create-game-session-queue
--name <value>
[--timeout-in-seconds <value>]
[--player-latency-policies <value>]
[--destinations <value>]
[--filter-configuration <value>]
[--priority-configuration <value>]
[--custom-event-data <value>]
[--notification-target <value>]
[--tags <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 (строка)

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

--player-latency-policies (список)

Упрощенный синтаксис:

MaximumIndividualPlayerLatencyMilliseconds=integer,PolicyDurationSeconds=integer ...

Синтаксис JSON:

[
  {
    "MaximumIndividualPlayerLatencyMilliseconds": integer,
    "PolicyDurationSeconds": integer
  }
  ...
]

--destinations (список)

Упрощенный синтаксис:

DestinationArn=string ...

Синтаксис JSON:

[
  {
    "DestinationArn": "string"
  }
  ...
]

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

Упрощенный синтаксис:

AllowedLocations=string,string

Синтаксис JSON:

{
  "AllowedLocations": ["string", ...]
}

--priority-configuration (структура)

Упрощенный синтаксис:

PriorityOrder=string,string,LocationOrder=string,string

Синтаксис JSON:

{
  "PriorityOrder": ["LATENCY"|"COST"|"DESTINATION"|"LOCATION", ...],
  "LocationOrder": ["string", ...]
}

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

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

--tags (список)

Упрощенный синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "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 (boolean)

Включить отладовую запись.

--endpoint-url (string)

Заменить значение по умолчанию URL команды на указанный URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с сервисами AWS. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команд.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

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

--version (string)

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

--color (string)

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

• on
• off
• auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию - 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию - 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат 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 (boolean)

Отключить паджер CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Пример 1: Создание очереди сессий игры в заданном порядке

Следующий create-game-session-queue пример создает новую очередь сессий игры с направлениями в двух регионах. Он также настраивает очередь таким образом, чтобы запросы сессий игры завершались с истечением времени ожидания размещения через 10 минут. Поскольку политики задержки не определены, GameLift пытается разместить все сессии игры с первым указанным направлением.

aws gamelift create-game-session-queue \
    --name MegaFrogRaceServer-NA \
    --destinations file://destinations.json \
    --timeout-in-seconds 600

Содержимое destinations.json:

{
    "Destinations": [
        {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" },
        {"DestinationArn": "arn:aws:gamelift:us-west-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" }
    ]
}

Вывод:

{
    "GameSessionQueues": [
        {
            "Name": "MegaFrogRaceServer-NA",
            "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRaceServer-NA",
            "TimeoutInSeconds": 600,
            "Destinations": [
                {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"},
                {"DestinationArn": "arn:aws:gamelift:us-west-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}
            ]
        }
    ]
}

Пример 2: Создание очереди сессий игры с политиками задержки игроков

Следующий create-game-session-queue пример создает новую очередь сессий игры с двумя политиками задержки игроков. Первая политика устанавливает предел задержки в 100 мс, который применяется в течение первой минуты попытки размещения сессии игры. Вторая политика увеличивает предел задержки до 200 мс до истечения времени ожидания запроса размещения через 3 минуты.

aws gamelift create-game-session-queue \
    --name MegaFrogRaceServer-NA \
    --destinations file://destinations.json \
    --player-latency-policies file://latency-policies.json \
    --timeout-in-seconds 180

Содержимое destinations.json:

{
    "Destinations": [
        { "DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" },
        { "DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" }
    ]
}

Содержимое latency-policies.json:

{
    "PlayerLatencyPolicies": [
        {"MaximumIndividualPlayerLatencyMilliseconds": 200},
        {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60}
    ]
}

Вывод:

{
    "GameSessionQueue": {
        "Name": "MegaFrogRaceServer-NA",
        "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:111122223333:gamesessionqueue/MegaFrogRaceServer-NA",
        "TimeoutInSeconds": 600,
        "PlayerLatencyPolicies": [
            {
                "MaximumIndividualPlayerLatencyMilliseconds": 100,
                "PolicyDurationSeconds": 60
            },
            {
                "MaximumIndividualPlayerLatencyMilliseconds": 200
            }
        ]
        "Destinations": [
            {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"},
            {"DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}
        ],
    }
}

Дополнительную информацию см. в разделе "Создание очереди" в Руководстве разработчика Amazon GameLift.

Вывод

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