create-stream-group

Описание

Управляйте потоками ваших приложений Amazon GameLift Streams с помощью группы потоков. Группа потоков — это набор ресурсов, которые Amazon GameLift Streams использует для потоковой передачи вашего приложения конечным пользователям. При создании группы потоков вы указываете приложение для потоковой передачи по умолчанию и тип оборудования, например, графический процессор (GPU). Вы также можете связать дополнительные приложения, что позволяет передавать эти приложения с помощью этой группы потоков. В зависимости от ожидаемого числа пользователей вы также масштабируете количество одновременных потоков, которые хотите поддерживать одновременно, и в каких местоположениях.

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

Всегда активная : емкость потоковой передачи, которая выделена и готова обрабатывать запросы потоков без задержки. Вы платите за эту емкость независимо от ее использования. Лучше всего подходит для наиболее быстрого времени от запроса на потоковую передачу до сеанса потоковой передачи. </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 adjust the capacity of any <code>ACTIVE</code> stream group, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html">UpdateStreamGroup</a>. If the request is successful, Amazon GameLift Streams begins creating the stream group. Amazon GameLift Streams assigns a unique ID to the stream group resource and sets the status to <code>ACTIVATING</code>. When the stream group reaches <code>ACTIVE</code> status, you can start stream sessions by using <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_StartStreamSession.html">StartStreamSession</a>. To check the stream group's status, call <a href="https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html">GetStreamGroup</a>.

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

Синтаксис

  create-stream-group
[--client-token <value>]
[--default-application-identifier <value>]
--description <value>
[--location-configurations <value>]
--stream-class <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]

Параметры

--client-token (строка)

Уникальный идентификатор, представляющий запрос клиента. Запрос идемпотентен, что гарантирует выполнение запроса API только один раз. Когда пользователи отправляют запрос, Amazon GameLift Streams автоматически заполняет это поле.

--default-application-identifier (строка)

Уникальный идентификатор приложения Amazon GameLift Streams, которое вы хотите связать с группой потоков в качестве приложения по умолчанию. Приложение должно находиться в статусе READY. Установив идентификатор приложения по умолчанию, вы оптимизируете время запуска этого приложения в вашей группе потоков. После установки это приложение не может быть отсоединено от группы потоков, в отличие от приложений, которые связаны с помощью AssociateApplications. Если при создании группы потоков он не задан, вам нужно будет вызвать AssociateApplications позже, прежде чем вы сможете начать потоковую передачу.

--description (строка)

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

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

--stream-class (строка)

Целевое качество потоковой передачи для сеансов, размещенных в этой группе потоков. Установите класс потока, соответствующий типу содержимого, которое вы передаете. Класс потока определяет тип вычислительных ресурсов, которые использует Amazon GameLift Streams, и влияет на стоимость потоковой передачи. Доступны следующие параметры:

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

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

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

gen4n_high
gen4n_ultra
gen4n_win2022
gen5n_high
gen5n_ultra
gen5n_win2022

--tags (словарь)

Список меток для назначения новому ресурсу группы потоков. Метки — это определенные разработчиками пары ключ-значение. Использование меток ресурсов Amazon Web Services полезно для управления ресурсами, управления доступом и распределения затрат. См. раздел «Использование меток ресурсов Amazon Web Services» в справочнике Amazon Web Services.

ключ -> (строка)

значение -> (строка)

Краткая синтаксическая запись:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "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 pager.

--cli-auto-prompt (boolean)

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

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

Отключить автоматическое запросы параметров ввода 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 -> (список)

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

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

АКТИВИРУЕТСЯ : Amazon GameLift Streams готовит расположение. Вы пока не можете транслировать из этого расположения, изменять его емкость или удалять его.
АКТИВНО : Расположение обеспечено начальной емкостью. Теперь вы можете транслировать из него, изменять его емкость или удалять его.
ОШИБКА : Amazon GameLift Streams не удалось настроить это расположение. Поле StatusReason описывает ошибку. Вы можете удалить это расположение и попытаться добавить его снова.
УДАЛЯЕТСЯ : 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 -> (строка)

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

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

АКТИВИРУЕТСЯ : Amazon GameLift Streams готовит расположение. Вы пока не можете транслировать из этого расположения, изменять его емкость или удалять его.
АКТИВНО : Расположение обеспечено начальной емкостью. Теперь вы можете транслировать из него, изменять его емкость или удалять его.
ОШИБКА : Amazon GameLift Streams не удалось настроить это расположение. Поле StatusReason описывает ошибку. Вы можете удалить это расположение и попытаться добавить его снова.
УДАЛЯЕТСЯ : 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 vCPU, 32 ГБ ОЗУ, 24 ГБ видеопамяти
- Доступность: Поддерживает 1 одновременную сессию потока
``gen5n_high`` (NVIDIA, high) Поддерживает приложения со средней по высокой сложностью 3D-сцены. Использует графический процессор NVIDIA A10G Tensor.
- Резолюция по умолчанию: 1080p
- Частота кадров по умолчанию: 60 кадр/с
- Характеристики рабочей нагрузки: 4 vCPU, 16 ГБ ОЗУ, 12 ГБ видеопамяти
- Доступность: Поддерживает до 2 одновременных сессий потока
``gen5n_ultra`` (NVIDIA, ultra) Поддерживает приложения с чрезвычайно высокой сложностью 3D-сцены. Использует выделенный графический процессор NVIDIA A10G Tensor.
- Резолюция по умолчанию: 1080p
- Частота кадров по умолчанию: 60 кадр/с
- Характеристики рабочей нагрузки: 8 vCPU, 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 vCPU, 32 ГБ ОЗУ, 16 ГБ видеопамяти
- Доступность: Поддерживает 1 одновременную сессию потока
``gen4n_high`` (NVIDIA, high) Поддерживает приложения со средней по высокой сложностью 3D-сцены. Использует графический процессор NVIDIA T4 Tensor.
- Резолюция по умолчанию: 1080p
- Частота кадров по умолчанию: 60 кадр/с
- Характеристики рабочей нагрузки: 4 vCPU, 16 ГБ ОЗУ, 8 ГБ видеопамяти
- Доступность: Поддерживает до 2 одновременных сессий потока
``gen4n_ultra`` (NVIDIA, ultra) Поддерживает приложения с высокой сложностью 3D-сцены. Использует выделенный графический процессор NVIDIA T4 Tensor.
- Резолюция по умолчанию: 1080p
- Частота кадров по умолчанию: 60 кадр/с
- Характеристики рабочей нагрузки: 8 vCPU, 32 ГБ ОЗУ, 16 ГБ видеопамяти
- Доступность: Поддерживает 1 одновременную сессию потока