Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

list-compute

Описание

Получает информацию о вычислительных ресурсах в флоте Amazon GameLift. Используйте параметры постраничной навигации для получения результатов в наборе последовательных страниц.

Параметры запроса
  • Получение списка всех вычислительных ресурсов в флоте. Укажите идентификатор флота.
  • Получение списка всех вычислительных ресурсов в определенном расположении флота. Укажите идентификатор флота и расположение.
Результаты

В случае успеха данная операция возвращает информацию о наборе вычислительных ресурсов. В зависимости от типа флота результат включает следующую информацию:

  • Для управляемого флота EC2 (тип вычислительного ресурса EC2) данная операция возвращает информацию об экземпляре EC2. Имена вычислительных ресурсов — это идентификаторы экземпляров EC2.
  • Для флота Anywhere (тип вычислительного ресурса ANYWHERE) данная операция возвращает имена вычислительных ресурсов и детали, с момента регистрации вычислительного ресурса в RegisterCompute. Это включает GameLiftServiceSdkEndpoint или GameLiftAgentEndpoint.

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

list-compute — это операция с постраничной навигацией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничную навигацию, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной навигацией, аргумент --query должен извлекать данные из результатов следующих выражений запроса: ComputeList

Синтаксис

  list-compute
--fleet-id <value>
[--location <value>]
[--container-group-definition-name <value>]
[--compute-status <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]

Параметры

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

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

--location (строка)

Имя расположения, для которого необходимо получить вычислительные ресурсы. Для флота Amazon GameLift Anywhere используйте пользовательское расположение. Для управляемого флота укажите регион Amazon Web Services или код локальной зоны (например: us-west-2 или us-west-2-lax-1).

--container-group-definition-name (строка)

Для вычислительных ресурсов в управляемом контейнерном флоте — имя определения развернутой группы контейнеров.

--compute-status (строка)

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

  • ACTIVE — Вычислительный ресурс развернут с правильными определениями контейнеров. Он готов обрабатывать игровые сервера и размещать игровые сессии.
  • IMPAIRED — Развертывание обновления вычислительного ресурса завершилось неудачно, и вычислительный ресурс развернут с неправильными определениями контейнеров.

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

  • ACTIVE
  • IMPAIRED

--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
  • текст
  • таблица
  • 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.

Вывод

ComputeList -> (список)

Список вычислительных ресурсов в указанном флоте.

(структура)

Вычислительный ресурс Amazon GameLift для размещения ваших игровых серверов. Вычислительные ресурсы в флоте Amazon GameLift различаются в зависимости от свойства типа вычислительного ресурса флота следующим образом:

  • Для управляемых флотов EC2, вычислительный ресурс — это экземпляр EC2.
  • Для Anywhere-флотов, вычислительный ресурс — это предоставляемый вами вычислительный ресурс, зарегистрированный в флоте.

FleetId -> (строка)

Уникальный идентификатор флота, к которому принадлежит вычислительный ресурс.

FleetArn -> (строка)

Идентификатор ресурса Amazon (ARN) флота, к которому принадлежит вычислительный ресурс.

ComputeName -> (строка)

Описание метки для вычислительного ресурса. Для экземпляров в управляемом флоте EC2 имя вычислительного ресурса совпадает со значением InstanceId ID.

ComputeArn -> (строка)

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

IpAddress -> (строка)

IP-адрес вычислительного ресурса. Amazon GameLift требует DNS-имя или IP-адрес для вычислительного ресурса.

DnsName -> (строка)

DNS-имя вычислительного ресурса. Amazon GameLift требует DNS-имя или IP-адрес для вычислительного ресурса.

ComputeStatus -> (строка)

Текущий статус вычислительного ресурса. Вычислительный ресурс должен иметь статус ACTIVE для размещения игровых сессий.

Location -> (строка)

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

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

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

OperatingSystem -> (строка)

Тип операционной системы на вычислительном ресурсе.

Примечание

Amazon Linux 2 (AL2) достигнет конца поддержки 30.06.2025 г. Подробнее см. в FAQ по Amazon Linux 2. Для игровых серверов, размещенных на AL2 и использующих версию серверного SDK 4.x для Amazon GameLift, сначала обновите сборку игрового сервера до серверного SDK 5.x, а затем разверните ее на экземплярах AL2023. См. Миграция на версию серверного SDK 5.

Type -> (строка)

Тип экземпляра Amazon EC2, используемого флотом. Для зарегистрированных вычислительных ресурсов в флоте Amazon GameLift Anywhere это свойство пустое.

GameLiftServiceSdkEndpoint -> (строка)

Точка подключения Amazon GameLift SDK для зарегистрированного вычислительного ресурса в Anywhere-флоте. Игровые серверы на вычислительном ресурсе используют эту точку подключения для соединения с сервисом Amazon GameLift.

GameLiftAgentEndpoint -> (строка)

Точка подключения агента Amazon GameLift.

InstanceId -> (строка)

InstanceID экземпляра EC2, на котором размещен вычислительный ресурс.

ContainerAttributes -> (список)

Набор атрибутов для каждого контейнера в вычислительном ресурсе.

(структура)

Уникальный идентификатор контейнера в вычислительном ресурсе контейнерного флота.

Возвращается: DescribeCompute

ContainerName -> (строка)

Идентификатор контейнера, работающего в вычислительном ресурсе.

ContainerRuntimeId -> (строка)

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

GameServerContainerGroupDefinitionArn -> (строка)

Определение группы контейнеров игровых серверов для вычислительного ресурса.

NextToken -> (строка)

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

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

Spec-Zone.ru

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