list-container-fleets
Описание
Получает набор ресурсов контейнерных флотов в регионе Amazon Web Services. Для флотов с несколькими локациями данная операция получает флоты только по их домашнему региону.
- Получить список всех флотов. Вызовите эту операцию без указания определения контейнерной группы.
- Получить список флотов, отфильтрованных по определению контейнерной группы. Укажите имя или значение ARN определения контейнерной группы.
- Чтобы получить список всех флотов Amazon GameLift Realtime со скриптом конфигурации, укажите ID скрипта.
Используйте параметры пагинации для получения результатов в виде набора последовательных страниц.
При успешном выполнении эта операция возвращает набор контейнерных флотов, соответствующих параметрам запроса. Также возвращается значение NextToken, если существуют дополнительные страницы результатов для извлечения.
Примечание
Идентификаторы флотов возвращаются в произвольном порядке.См. также: Документацию AWS API
list-container-fleets является операцией с пагинацией. Для получения всего набора результатов могут быть выполнены несколько API-запросов. Вы можете отключить пагинацию, указав параметр --no-paginate. При использовании --output text и параметра --query в ответе с пагинацией параметр --query должен извлекать данные из результатов следующих выражений запроса: ContainerFleets
Синопсис
list-container-fleets
[--container-group-definition-name <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]
Параметры
--container-group-definition-name (строка)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перепишут значения, предоставленные в JSON. Невозможно передавать произвольные двоичные данные, используя значение, предоставленное в JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания, с какой позиции начать пагинацию. Это значение NextToken из предыдущего усечённого ответа.
Примеры использования см. в разделе Пагинация в Руководстве пользователя AWS Command Line Interface.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания AWS-вызовов.
Примеры использования см. в разделе Пагинация в Руководстве пользователя AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления пагинации укажите значение NextToken в параметре starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Пагинация в Руководстве пользователя AWS Command Line Interface.
--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 для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматический запрос параметров CLI.
Вывод
ContainerFleets -> (список)
Коллекция объектов контейнерных флотов для всех флотов, соответствующих критериям запроса.
(структура)
Описание управляемого контейнерного флота Amazon GameLift.
FleetId -> (строка)
FleetArn -> (строка)
arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. В ARN флота GameLift идентификатор ресурса соответствует значению FleetId.FleetRoleArn -> (строка)
GameServerContainerGroupDefinitionName -> (строка)
GameServerContainerGroupDefinitionArn -> (строка)
PerInstanceContainerGroupDefinitionName -> (строка)
PerInstanceContainerGroupDefinitionArn -> (строка)
InstanceConnectionPortRange -> (структура)
Набор номеров портов, которые нужно открыть на каждом экземпляре в контейнерном флоте. Порты подключения используются входящим трафиком для подключения к процессам, выполняющимся в контейнерах в этом флоте.
FromPort -> (целое число)
ToPort -> (целое число)
FromPort.InstanceInboundPermissions -> (список)
Диапазоны IP-адресов и настройки портов, которые разрешают входящий трафик для доступа к процессам серверов игр и другим процессам в этом флоте.
(структура)
Диапазон IP-адресов и настроек портов, которые позволяют входящему трафику подключаться к процессам на экземпляре в флоте. Процессам присваивается комбинация IP-адрес/порт, которая должна соответствовать разрешенным диапазонам флота.
Для флотов Amazon GameLift Realtime Amazon GameLift автоматически открывает два диапазона портов, один для TCP-сообщений и один для UDP.
FromPort -> (целое число)
Начальное значение диапазона разрешенных номеров портов.
Для флотов, использующих Linux-сборки, допустимы только порты 22 и 1026-60000.
Для флотов, использующих Windows-сборки, допустимы только порты 1026-60000.
ToPort -> (целое число)
Конечное значение диапазона разрешенных номеров портов. Номера портов включают конечные значения. Это значение должно быть равно или больше FromPort.
Для флотов, использующих Linux-сборки, допустимы только порты 22 и 1026-60000.
Для флотов, использующих Windows-сборки, допустимы только порты 1026-60000.
IpRange -> (строка)
000.000.000.000/[subnet mask] ” или необязательно сокращенная версия “0.0.0.0/[subnet mask] ”.Protocol -> (строка)
GameServerContainerGroupsPerInstance -> (целое число)
MaximumGameServerContainerGroupsPerInstance -> (целое число)
InstanceType -> (строка)
BillingType -> (строка)
Указывает, использует ли флот экземпляры On-Demand или Spot для этого флота. Узнайте больше о том, когда следует использовать On-Demand или Spot-экземпляры. Вы не можете обновить это свойство флота.
По умолчанию это свойство установлено в ON_DEMAND.
Description -> (строка)
CreationTime -> (временная метка)
"1469498468.057").MetricGroups -> (список)
Имя группы метрик Amazon Web Services CloudWatch, к которой нужно добавить этот флот. Группы метрик агрегируют метрики для нескольких флотов.
(строка)
NewGameSessionProtectionPolicy -> (строка)
Определяет, может ли Amazon GameLift останавливать игровые сессии на флоте, которые активно работают и принимают игроков. Amazon GameLift может запросить остановку экземпляра при уменьшении емкости флота или при удалении неисправных экземпляров. Вы также можете установить защиту игровых сессий для отдельных игровых сессий, используя UpdateGameSession.
- NoProtection – Игровые сессии могут быть остановлены во время активной игры.
-
FullProtection – Игровые сессии в состоянии
ACTIVEне могут быть остановлены.
GameSessionCreationLimitPolicy -> (структура)
Политика, ограничивающая количество игровых сессий, которые каждый отдельный игрок может создавать на экземплярах в этом флоте. Ограничение действует в течение определенного промежутка времени.
NewGameSessionsPerCreator -> (целое число)
Политика, которая накладывает ограничения на количество игровых сессий, которые игрок может создать в течение заданного промежутка времени. С помощью этой политики вы можете контролировать способность игроков потреблять доступные ресурсы.
Политика оценивает, когда игрок пытается создать новую игровую сессию. При получении запроса CreateGameSession Amazon GameLift проверяет, создал ли игрок (определяемый по CreatorId) меньше, чем лимит игровых сессий в указанный период времени.
PolicyPeriodInMinutes -> (целое число)
Status -> (строка)
Текущий статус контейнерного флота.
-
PENDING– Запрошен новый контейнерный флот. -
CREATING– Создается новый ресурс контейнерного флота. -
CREATED– Создан новый ресурс контейнерного флота. Экземпляры флота не развернуты. -
ACTIVATING– Развертываются новые экземпляры контейнерного флота. -
ACTIVE– Контейнерный флот развернут и готов к размещению игровых сессий. -
UPDATING– Обновление контейнерного флота. Процесс развертывания в процессе.
DeploymentDetails -> (структура)
Информация о последнем развертывании контейнерного флота.
LatestDeploymentId -> (строка)
LogConfiguration -> (структура)
Метод, используемый для сбора журналов контейнеров для флота. Amazon GameLift сохраняет весь стандартный вывод каждого контейнера в журналах, включая журналы игровых сессий.
-
CLOUDWATCH– Отправка журналов в группу журналов Amazon CloudWatch, которую вы определяете. Каждый контейнер генерирует поток журнала, организованный в группе журнала. -
S3– Сохранение журналов в ведре Amazon S3, которое вы определяете. -
NONE– Не собирать журналы контейнеров.
LogDestination -> (строка)
Тип сбора журналов для флота.
-
CLOUDWATCH– (значение по умолчанию) Отправка журналов в группу журналов Amazon CloudWatch, которую вы определяете. Каждый контейнер генерирует поток журнала, организованный в группе журнала. -
S3– Сохранение журналов в ведре Amazon S3, которое вы определяете. Это ведро должно находиться в домашнем регионе Amazon Web Services флота. -
NONE– Не собирать журналы контейнеров.
S3BucketName -> (строка)
S3, журналы отправляются в указанное имя ведра Amazon S3.LogGroupArn -> (строка)
CLOUDWATCH, журналы отправляются в указанную группу журналов в Amazon CloudWatch.LocationAttributes -> (список)
Информация о удаленных расположениях контейнерного флота, где развернуты экземпляры флота.
(структура)
Подробная информация о расположении в контейнерном флоте с несколькими расположениями.
Location -> (строка)
Status -> (строка)
Статус активности флота в расположении.
-
PENDING– Запрошен новый контейнерный флот. -
CREATING– Создается новый ресурс контейнерного флота. -
CREATED– Создан новый ресурс контейнерного флота. Экземпляры флота не развернуты. -
ACTIVATING– Развертываются новые экземпляры контейнерного флота. -
ACTIVE– Контейнерный флот развернут и готов к размещению игровых сессий. -
UPDATING– Обновление контейнерного флота. Процесс развертывания в процессе.
NextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.