Spec-Zone.ru › AWS CLI v2

[ 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 -> (целое число)

Ёмкость потоковой передачи, которую 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
  • текст
  • таблица
  • 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 -> (строка)

Это значение представляет собой Amazon Resource Name (ARN), уникально идентифицирующий ресурс группы потоков. Пример формата: 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 -> (целое число)

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

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

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

Status -> (строка)

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

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

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

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

Spec-Zone.ru

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