Spec-Zone.ru › AWS CLI v2

[ aws . gameliftstreams ]

create-application

Описание

Создаёт ресурс приложения в Amazon GameLift Streams, который определяет контент приложения для потоковой передачи, например, сборку игры или другое программное обеспечение, и настраивает параметры для его запуска.

Перед созданием приложения загрузите файлы контента приложения в бакет Amazon Simple Storage Service (Amazon S3). Дополнительная информация доступна в разделе Начало работы в руководстве разработчика Amazon GameLift Streams.

Предупреждение

Убедитесь, что файлы в бакете Amazon S3 являются нужной версией. После создания приложения Amazon GameLift Streams изменить файлы впоследствии нельзя.

При успешном запросе Amazon GameLift Streams начинает создание приложения и устанавливает статус в INITIALIZED. Когда приложение достигнет статуса READY, вы можете использовать его для настройки групп потоков и запуска потоков. Для отслеживания статуса приложения используйте вызов GetApplication.

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

Синтаксис

  create-application
[--application-log-output-uri <value>]
[--application-log-paths <value>]
--application-source-uri <value>
[--client-token <value>]
--description <value>
--executable-path <value>
--runtime-environment <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]

Параметры

--application-log-output-uri (строка)

URI Amazon S3 для бакета, в котором Amazon GameLift Streams должен сохранять журналы приложения. Требуется, если указан один или несколько ApplicationLogPaths.

Примечание

Бакет журналов должен иметь разрешения, предоставляющие Amazon GameLift Streams доступ для записи файлов журналов. Дополнительную информацию см. в разделе Начало работы в руководстве разработчика Amazon GameLift Streams.

--application-log-paths (список)

Расположения файлов журналов, генерируемых контентом во время сессии потоковой передачи. Введите значения путей относительно расположения ApplicationSourceUri. Вы можете указать до 10 путей к файлам журналов. Amazon GameLift Streams загружает указанные файлы журналов в бакет Amazon S3, указанный в ApplicationLogOutputUri в конце сессии потоковой передачи. Чтобы получить сохранённые файлы журналов, используйте вызов GetStreamSession и получите LogFileLocationUri.

(строка)

Синтаксис:

"string" "string" ...

--application-source-uri (строка)

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

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

Примечание

Бакет Amazon S3 и приложение Amazon GameLift Streams должны находиться в одной и той же области Amazon Web Services.

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

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

--description (строка)

Читабельное обозначение для приложения. Вы можете обновить это значение позже.

--executable-path (строка)

Путь и имя исполняемого файла, запускающего контент для потоковой передачи. Введите значение пути относительно расположения, указанного в ApplicationSourceUri.

--runtime-environment (структура)

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

Рабочая среда может быть следующей:

  • Для приложений Linux
    • Ubuntu 22.04 LTS (Type=UBUNTU, Version=22_04_LTS )
  • Для приложений Windows
    • Microsoft Windows Server 2022 Base (Type=WINDOWS, Version=2022 )
    • Proton 8.0-5 (Type=PROTON, Version=20241007 )
    • Proton 8.0-2c (Type=PROTON, Version=20230704 )

Тип -> (строка)

Операционная система и другие драйверы. Для Proton это также включает совместимый слой Proton.

Версия -> (строка)

Версионированная контейнерная среда для операционной системы приложения.

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

Type=string,Version=string

JSON синтаксис:

{
  "Type": "PROTON"|"WINDOWS"|"UBUNTU",
  "Version": "string"
}

--tags (карта)

Список тегов для назначения новому ресурсу приложения. Теги — это определяемые разработчиком пары "ключ-значение". Использование тегов для ресурсов Amazon Web Services полезно для управления ресурсами, управления доступом и распределения затрат. См. Раздел "Использование тегов для ресурсов Amazon Web Services" в Общие сведения об Amazon Web Services. Вы можете добавить теги с помощью TagResource, удалить их с помощью UntagResource и просмотреть теги существующих ресурсов с помощью ListTagsForResource.

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

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

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

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 (булево)

Включает отладку.

--endpoint-url (строка)

Переопределяет URL по умолчанию команды на заданный URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию, которое заключается в проверке сертификатов SSL.

--no-paginate (булево)

Отключает автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования выходных данных команды.

  • json
  • text
  • таблица
  • yaml
  • yaml-stream

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

Вывод

ApplicationLogOutputUri -> (строка)

Amazon S3 URI для ведра, в котором Amazon GameLift Streams будет сохранять журналы приложения. Требуется, если вы указали один или несколько ApplicationLogPaths .

ApplicationLogPaths -> (список)

Расположения файлов журналов, которые генерирует ваш контент во время сеанса потоковой передачи. Amazon GameLift Streams загружает файлы журналов в ведро Amazon S3, которое вы указали в ApplicationLogOutputUri в конце сеанса потоковой передачи. Чтобы получить сохраненные файлы журналов, вызовите GetStreamSession и получите LogFileLocationUri .

(строка)

ApplicationSourceUri -> (строка)

Исходное расположение в Amazon S3 загруженного контента потока для приложения.

Arn -> (строка)

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

AssociatedStreamGroups -> (список)

Новое приложение не ассоциировано ни с одной группой потоковой передачи. Это значение пустое.

(строка)

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

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

Description -> (строка)

Человеко-читаемый ярлык для приложения. Вы можете изменить это значение.

ExecutablePath -> (строка)

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

Id -> (строка)

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

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

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

ReplicationStatuses -> (список)

Набор статусов репликации для каждого расположения.

(структура)

Представляет статус репликации приложения в данном расположении. Приложение нельзя запускать в потоковой передаче из расположения до завершения репликации туда.

Location -> (строка)

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

Status -> (строка)

Текущий статус процесса репликации.

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

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

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

  • Для приложений Linux
    • Ubuntu 22.04 LTS (Type=UBUNTU, Version=22_04_LTS )
  • Для приложений Windows
    • Microsoft Windows Server 2022 Base (Type=WINDOWS, Version=2022 )
    • Proton 8.0-5 (Type=PROTON, Version=20241007 )
    • Proton 8.0-2c (Type=PROTON, Version=20230704 )

Type -> (строка)

Операционная система и другие драйверы. Для Proton это также включает совместимый слой Proton.

Version -> (строка)

Версионированная контейнерная среда для операционной системы приложения.

Status -> (строка)

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

  • INITIALIZED : Amazon GameLift Streams получил запрос и начинает процесс создания приложения.
  • PROCESSING : Процесс создания приложения в работе. Amazon GameLift Streams копирует контент и кэширует его для будущего развертывания в группе потоковой передачи.
  • READY : Приложение готово к развертыванию в группе потоковой передачи.
  • ERROR : При установке приложения произошла ошибка. См. StatusReason для получения дополнительной информации.
  • DELETING : Amazon GameLift Streams выполняет удаление приложения.

StatusReason -> (строка)

Краткое описание причины статуса, когда приложение находится в статусе ERROR .

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

Spec-Zone.ru

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