[ aws . gameliftstreams ]
Добавление расположений для группы потоков
Описание
Добавление расположений, которые могут принимать сеансы потоковой передачи. Вы настраиваете расположения и соответствующую им ёмкость для каждой группы потоков. Создание группы потоков в расположении, которое находится ближе к вашим конечным пользователям, может помочь минимизировать задержку и улучшить качество.
Данная операция резервирует ёмкость потоковой передачи в указанных расположениях. По умолчанию все расположения имеют ёмкость 1 или 2, в зависимости от выбранного класса потока: 2 для «Высокий» и 1 для «Ультра» и «Win2022». Эта операция также копирует файлы контента всех связанных приложений во внутренёный S3-ведро в каждом расположении. Это позволяет Amazon GameLift Streams принимать эффективные сеансы потоковой передачи.
См. также: Документация AWS API
Синтаксис
add-stream-group-locations
--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]
Параметры
--identifier (строка)
Группа потоков, к которой необходимо добавить указанные расположения.
Это значение представляет собой Amazon Resource Name (ARN), уникально идентифицирующий ресурс группы потоков. Пример формата: sg-1AB2C3De4 .
--location-configurations (список)
Набор из одного или нескольких расположений и ёмкость потоковой передачи для каждого расположения.
(структура)
Настройка параметров, определяющих ёмкость потоков группы потоков для расположения. При первой настройке расположения необходимо указать численное значение хотя бы для одного из двух типов ёмкости. Для обновления ёмкости существующей группы потоков необходимо вызвать UpdateStreamGroup. Для добавления нового расположения и указания его ёмкости необходимо вызвать AddStreamGroupLocations.
AlwaysOnCapacity -> (целое число)
LocationName -> (строка)
us-east-1 . Полный список расположений, поддерживаемых Amazon GameLift Streams, см. в разделе «Регионы и квоты» в руководстве разработчика Amazon GameLift Streams.OnDemandCapacity -> (целое число)
Сокращенный синтаксис:
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
- текст
- таблица
- 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.
Вывод
Identifier -> (строка)
sg-1AB2C3De4 .Locations -> (список)
Это значение представляет собой набор расположений, включая их имя, текущий статус и ёмкости.
Расположение может находиться в одном из следующих состояний:
- 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 -> (целое число)
RequestedCapacity -> (целое число)
Status -> (строка)
Это значение представляет собой набор расположений, включая их имя, текущий статус и ёмкости.
Расположение может находиться в одном из следующих состояний:
- ACTIVATING : Amazon GameLift Streams готовит расположение. Вы пока не можете передавать данные из этого расположения, масштабировать его ёмкость или удалить его.
- ACTIVE : Расположение подготовлено с начальной ёмкостью. Теперь вы можете передавать данные из этого расположения, масштабировать его ёмкость или удалить его.
- ERROR : Amazon GameLift Streams не удалось настроить это расположение. Поле StatusReason описывает ошибку. Вы можете удалить это расположение и попробовать добавить его снова.
- REMOVING : Amazon GameLift Streams пытается удалить это расположение. Оно высвобождает всю выделенную ёмкость для этого расположения в этой группе потоков.
© Copyright 2025, Amazon Web Services. Created using Sphinx.