Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

describe-runtime-configuration

Описание

Получает параметры конфигурации выполнения флота. Конфигурация выполнения определяет, какие серверные процессы выполняются и как на вычислительных узлах в флоте. Для управляемых EC2 флотов конфигурация выполнения описывает серверные процессы, которые выполняются на каждом экземпляре флота. можно обновить конфигурацию выполнения флота в любое время с помощью UpdateRuntimeConfiguration .

Чтобы получить текущую конфигурацию выполнения флота, укажите идентификатор флота.

При успешном выполнении возвращается объект RuntimeConfiguration для запрошенного флота. Если запрошенный флот был удалён, результат пустой.

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

Настройка флотов Amazon GameLift

Запуск нескольких процессов в флоте

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

Синтаксис

  describe-runtime-configuration
--fleet-id <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]

Параметры

--fleet-id (строка)

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

--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 (строка)

Переопределить адрес по умолчанию команды на указанный адрес.

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

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Подробнее об этом см. в руководстве по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, характерные для Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. Подробнее см. раздел "Использование кавычек со строками" в руководстве пользователя AWS CLI.

Чтобы запросить конфигурацию выполнения для флота

Следующий пример describe-runtime-configuration извлекает сведения о текущей конфигурации выполнения для указанного флота.

aws gamelift describe-runtime-configuration \
    --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Вывод:

{
    "RuntimeConfiguration": {
        "ServerProcesses": [
            {
                "LaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe",
                "Parameters": "+gamelift_start_server",
                "ConcurrentExecutions": 3
            },
            {
                "LaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe",
                "Parameters": "+gamelift_start_server +debug",
                "ConcurrentExecutions": 1
            }
        ],
        "MaxConcurrentGameSessionActivations": 2147483647,
        "GameSessionActivationTimeoutSeconds": 300
    }
}

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

Вывод

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

Инструкции по запуску и обслуживанию серверных процессов на вычислительных узлах в флоте.

ServerProcesses -> (список)

Коллекция конфигураций серверных процессов, определяющих, какие серверные процессы запустить на вычислительных узлах флота.

(структура)

Набор инструкций для запуска серверных процессов на вычислительных узлах флота. Серверные процессы выполняют либо исполняемый файл в пользовательском игровом сборе, либо скрипт Amazon GameLift Realtime. Конфигурации серверных процессов являются частью конфигурации выполнения флота.

LaunchPath -> (строка)

Расположение исполняемого файла игрового сборки или скрипта Realtime. Игровые сборки и скрипты Realtime устанавливаются на экземплярах в корневой папке:

  • Windows (только пользовательские игровые сборки): C:\game . Пример: “C:\game\MyGame\server.exe “
  • Linux: /local/game . Примеры: “/local/game/MyGame/server.exe “ или “/local/game/MyRealtimeScript.js “

Примечание

Amazon GameLift не поддерживает использование скриптов установки для запуска исполняемого файла игры. Для пользовательских игровых сборок этот параметр должен указывать исполняемый файл, вызывающий операции серверного SDK initSDK() и ProcessReady().

Parameters -> (строка)

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

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

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

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

Количество игровых сессий в статусе ACTIVATING, разрешенных на экземпляре или вычислительном узле. Эта настройка ограничивает ресурсы экземпляра, которые могут использоваться для активации новых игровых сессий в любой момент времени.

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

Максимальное время (в секундах), разрешенное для запуска новой игровой сессии и уведомления о её готовности к размещению игроков. В течение этого времени игровая сессия находится в статусе ACTIVATING. Если игровая сессия не станет активной до истечения таймаута, она завершается, и статус игровой сессии изменяется на TERMINATED.

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

Spec-Zone.ru

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