update-stream-group

Описание

Обновляет параметры конфигурации ресурса группы потоков Amazon GameLift Streams. Вы можете изменить описание, набор расположений и запрашиваемую ёмкость группы потоков в каждом расположении. Если вы хотите изменить класс потоков, создайте новую группу потоков.

Ёмкость потоков представляет собой количество одновременных активных потоков. Вы задаёте ёмкость потоков на расположение и на группу потоков. Существуют два типа ёмкости: постоянная и по запросу:

Постоянная : ёмкость потоковой передачи, которая выделена и готова обрабатывать запросы на потоки без задержки. Вы платите за эту ёмкость независимо от её использования. Лучше всего подходит для наименьшего времени от запроса на потоковую передачу до сеанса потоковой передачи. </li> <li> On-demand: The streaming capacity that Amazon GameLift Streams can allocate in response to stream requests, and then de-allocate when the session has terminated. This offers a cost control measure at the expense of a greater startup time (typically under 5 minutes). </li> </ul> To update a stream group, specify the stream group's Amazon Resource Name (ARN) and provide the new values. If the request is successful, Amazon GameLift Streams returns the complete updated metadata for the stream group.

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

Синтаксис

  update-stream-group
[--description <value>]
--identifier <value>
[--location-configurations <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]

Параметры

--description (строка)

Дескриптор группы потоков.

--identifier (строка)

Идентификатор или Amazon Resource Name (ARN), уникально определяющий ресурс группы потоков. Пример формата: ARN-arn:aws:gameliftstreams:us-west-2:123456789012:streamgroup/sg-1AB2C3De4 или ID-sg-1AB2C3De4 .

--location-configurations (список)

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

(структура)

Параметры конфигурации, определяющие ёмкость потоковой передачи группы потоков для расположения. При первой конфигурации расположения необходимо указать численное значение хотя бы для одного из двух типов ёмкости. Для обновления ёмкости существующей группы потоков вызовите UpdateStreamGroup . Чтобы добавить новое расположение и указать его ёмкость, вызовите AddStreamGroupLocations .

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

Ёмкость потоковой передачи, которая выделена и готова обрабатывать запросы на потоки без задержки. Вы платите за эту ёмкость независимо от её использования. Лучше всего подходит для наименьшего времени от запроса на потоковую передачу до сеанса потоковой передачи.

LocationName -> (строка)

Имя расположения. Например, us-east-1 . Полный список поддерживаемых Amazon GameLift Streams расположений см. в разделе «Регионы и квоты» в руководстве разработчика Amazon GameLift Streams.

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

Ёмкость потоковой передачи, которую Amazon GameLift Streams может выделить в ответ на запросы на потоки и затем освободить после завершения сеанса. Это обеспечивает контроль затрат за счёт большей начальной загрузки (как правило, менее 5 минут).

Сокращённый синтаксис:

AlwaysOnCapacity=integer,LocationName=string,OnDemandCapacity=integer ...

Синтаксис JSON:

[
  {
    "AlwaysOnCapacity": integer,
    "LocationName": "string",
    "OnDemandCapacity": integer
  }
  ...
]

--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 для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

Arn -> (строка)

Идентификатор ресурса Amazon (ARN), назначенный ресурсу группы потоков и уникально идентифицирующий группу во всех регионах Amazon Web Services. Формат: arn:aws:gameliftstreams:[AWS Region]:[AWS account]:streamgroup/[resource ID] .

AssociatedApplications -> (список)

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

Это набор идентификаторов ресурсов Amazon (ARN), уникально идентифицирующих ресурсы приложений. Пример формата: arn:aws:gameliftstreams:us-west-2:123456789012:application/a-9ZY8X7Wv6 .

(строка)

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

Метка времени, указывающая время создания этого ресурса. Метки времени выражаются в формате ISO8601, например: 2022-12-27T22:29:40+00:00 (UTC).

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

Приложение Amazon GameLift Streams по умолчанию, связанное с этой группой потоков.

Arn -> (строка)

Идентификатор ресурса Amazon (ARN), уникально идентифицирующий ресурс приложения. Пример формата: arn:aws:gameliftstreams:us-west-2:123456789012:application/a-9ZY8X7Wv6 .

Id -> (строка)

Уникальный идентификатор ресурса приложения. Например: a-9ZY8X7Wv6 .

Description -> (строка)

Описание группы потоков.

Id -> (строка)

Уникальное значение идентификатора, назначенное ресурсу при его создании. Пример формата: sg-1AB2C3De4 .

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

Метка времени, указывающая время последнего обновления этого ресурса. Метки времени выражаются в формате ISO8601, например: 2022-12-27T22:29:40+00:00 (UTC).

LocationStates -> (список)

Это набор расположений, включая их имя, текущий статус и емкость.

Расположение может находиться в одном из следующих состояний:

ACTIVATING : Amazon GameLift Streams подготавливает расположение. Вы пока не можете передавать потоки, изменять емкость или удалять это расположение.
ACTIVE : Расположение снабжено начальной емкостью. Теперь вы можете передавать потоки, изменять емкость или удалять это расположение.
ERROR : Amazon GameLift Streams не смог настроить это расположение. Поле StatusReason описывает ошибку. Вы можете удалить это расположение и попробовать добавить его снова.
REMOVING : Amazon GameLift Streams работает над удалением этого расположения. Оно высвобождает всю выделенную емкость для этого расположения в этой группе потоков.

(структура)

Представляет расположение и соответствующую емкость потоков и статус.

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

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

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

Емкость потоковой передачи, выделенная и готовая обрабатывать запросы на передачу потоков без задержек. Вы оплачиваете эту емкость независимо от того, используется она или нет. Лучше всего подходит для самого быстрого времени от запроса на передачу потока до сессии потоковой передачи.

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

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

LocationName -> (строка)

Имя расположения. Например, us-east-1 . Полный список расположений, поддерживаемых Amazon GameLift Streams, см. в разделе Регионы и квоты в Руководстве разработчика Amazon GameLift Streams.

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

Емкость потоковой передачи, которую Amazon GameLift Streams может выделять в ответ на запросы на передачу потоков и затем высвобождать, когда сессия завершена. Это обеспечивает управление затратами за счет более длительного времени запуска (обычно менее 5 минут).

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

Это общее количество вычислительных ресурсов, которое вы запрашиваете для группы потоков. Включает ресурсы, которые Amazon GameLift Streams уже выделил или пытается выделить. Вы запрашиваете емкость для каждого расположения в группе потоков.

Status -> (строка)

Это набор расположений, включая их имя, текущий статус и емкость.

Расположение может находиться в одном из следующих состояний:

ACTIVATING : Amazon GameLift Streams подготавливает расположение. Вы пока не можете передавать потоки, изменять емкость или удалять это расположение.
ACTIVE : Расположение снабжено начальной емкостью. Теперь вы можете передавать потоки, изменять емкость или удалять это расположение.
ERROR : Amazon GameLift Streams не смог настроить это расположение. Поле StatusReason описывает ошибку. Вы можете удалить это расположение и попробовать добавить его снова.
REMOVING : Amazon GameLift Streams работает над удалением этого расположения. Оно высвобождает всю выделенную емкость для этого расположения в этой группе потоков.

Status -> (строка)

Текущий статус ресурса группы потоков. Возможные статусы включают:

ACTIVATING : Группа потоков развертывается и не готова принимать потоки.
ACTIVE : Группа потоков готова принимать потоки.
ACTIVE_WITH_ERRORS : Одно или несколько расположений в группе потоков находятся в состоянии ошибки. Проверьте детали отдельных расположений и удалите любые расположения, находящиеся в состоянии ошибки.
ERROR : При развертывании группы потоков произошла ошибка. См. StatusReason для получения дополнительной информации.
DELETING : Amazon GameLift Streams удаляет группу потоков.
UPDATING_LOCATIONS : Одно или несколько расположений в группе потоков находятся в процессе обновления (активации или удаления).

StatusReason -> (строка)

Краткое описание причины, по которой группа потоков находится в состоянии ERROR. Возможные причины:

internalError : Запрос не может быть обработан в данный момент из-за проблемы с сервером. Попробуйте позже. Обратитесь в службу поддержки Amazon GameLift Streams для получения дополнительной помощи.
noAvailableInstances : В настоящее время у Amazon GameLift Streams недостаточно доступной емкости по требованию для выполнения вашего запроса. Подождите несколько минут и повторите запрос, так как емкость может часто изменяться. Вы также можете попробовать выполнить запрос с использованием другого класса потоков или в другом регионе.

StreamClass -> (строка)

Целевое качество потока для группы потоков.

Класс потока может быть одним из следующих:

``gen5n_win2022`` (NVIDIA, ultra) Поддерживает приложения с очень высокой сложностью 3D-сцены. Запускает приложения на Microsoft Windows Server 2022 Base и поддерживает DirectX 12. Совместим с версиями Unreal Engine до 5.4, 32- и 64-разрядными приложениями и технологией античит. Использует графический процессор NVIDIA A10G Tensor.
- Справочное разрешение: 1080p
- Справочная частота кадров: 60 кадров/с
- Технические характеристики рабочей нагрузки: 8 ядер процессора, 32 ГБ ОЗУ, 24 ГБ видеопамяти
- Аренда: Поддерживает 1 одновременную сессию потоковой передачи
``gen5n_high`` (NVIDIA, high) Поддерживает приложения со средней и высокой сложностью 3D-сцены. Использует графический процессор NVIDIA A10G Tensor.
- Справочное разрешение: 1080p
- Справочная частота кадров: 60 кадров/с
- Технические характеристики рабочей нагрузки: 4 ядра процессора, 16 ГБ ОЗУ, 12 ГБ видеопамяти
- Аренда: Поддерживает до 2 одновременных сессий потоковой передачи
``gen5n_ultra`` (NVIDIA, ultra) Поддерживает приложения с очень высокой сложностью 3D-сцены. Использует выделенный графический процессор NVIDIA A10G Tensor.
- Справочное разрешение: 1080p
- Справочная частота кадров: 60 кадров/с
- Технические характеристики рабочей нагрузки: 8 ядер процессора, 32 ГБ ОЗУ, 24 ГБ видеопамяти
- Аренда: Поддерживает 1 одновременную сессию потоковой передачи
``gen4n_win2022`` (NVIDIA, ultra) Поддерживает приложения с очень высокой сложностью 3D-сцены. Запускает приложения на Microsoft Windows Server 2022 Base и поддерживает DirectX 12. Совместим с версиями Unreal Engine до 5.4, 32- и 64-разрядными приложениями и технологией античит. Использует графический процессор NVIDIA T4 Tensor.
- Справочное разрешение: 1080p
- Справочная частота кадров: 60 кадров/с
- Технические характеристики рабочей нагрузки: 8 ядер процессора, 32 ГБ ОЗУ, 16 ГБ видеопамяти
- Аренда: Поддерживает 1 одновременную сессию потоковой передачи
``gen4n_high`` (NVIDIA, high) Поддерживает приложения со средней и высокой сложностью 3D-сцены. Использует графический процессор NVIDIA T4 Tensor.
- Справочное разрешение: 1080p
- Справочная частота кадров: 60 кадров/с
- Технические характеристики рабочей нагрузки: 4 ядра процессора, 16 ГБ ОЗУ, 8 ГБ видеопамяти
- Аренда: Поддерживает до 2 одновременных сессий потоковой передачи
``gen4n_ultra`` (NVIDIA, ultra) Поддерживает приложения с высокой сложностью 3D-сцены. Использует выделенный графический процессор NVIDIA T4 Tensor.
- Справочное разрешение: 1080p
- Справочная частота кадров: 60 кадров/с
- Технические характеристики рабочей нагрузки: 8 ядер процессора, 32 ГБ ОЗУ, 16 ГБ видеопамяти
- Аренда: Поддерживает 1 одновременную сессию потоковой передачи