Spec-Zone.ru › AWS CLI v2

[ aws . appstream ]

create-app-block

Описание

Создает блок приложения.

Блоки приложений — это ресурс Amazon AppStream 2.0, который хранит подробности о виртуальном жестком диске в ведре S3. Он также хранит скрипт настройки с подробными сведениями о том, как смонтировать виртуальный жесткий диск. Виртуальный жесткий диск включает двоичные файлы приложения и другие файлы, необходимые для запуска ваших приложений. Несколько приложений могут быть назначены одному блоку приложения.

Поддерживается только для гибких флотов.

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

Синтаксис

  create-app-block
--name <value>
[--description <value>]
[--display-name <value>]
--source-s3-location <value>
[--setup-script-details <value>]
[--tags <value>]
[--post-setup-script-details <value>]
[--packaging-type <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]

Параметры

--name (строка)

Имя блока приложения.

--description (строка)

Описание блока приложения.

--display-name (строка)

Отображаемое имя блока приложения. Оно не отображается пользователю.

--source-s3-location (структура)

Местоположение источника блока приложения в S3.

S3Bucket -> (строка)

Ведро S3 объекта S3.

S3Key -> (строка)

Ключ S3 объекта S3.

Это обязательно при использовании для следующих целей:

  • IconS3Location (Действия: CreateApplication и UpdateApplication)
  • SessionScriptS3Location (Действия: CreateFleet и UpdateFleet)
  • ScriptDetails (Действия: CreateAppBlock)
  • SourceS3Location при создании блока приложения с типом упаковки CUSTOM (Действия: CreateAppBlock)
  • SourceS3Location при создании блока приложения с типом упаковки APPSTREAM2, и использовании существующего пакета приложения (файл VHD). В этом случае S3Key относится к файлу VHD. Если требуется новый пакет приложения, то S3Key не требуется. (Действия: CreateAppBlock)

Краткая форма синтаксиса:

S3Bucket=string,S3Key=string

Синтаксис JSON:

{
  "S3Bucket": "string",
  "S3Key": "string"
}

--setup-script-details (структура)

Подробности скрипта настройки блока приложения. Это необходимо для типа упаковки CUSTOM.

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

Местоположение объекта S3 для скрипта.

S3Bucket -> (строка)

Ведро S3 объекта S3.

S3Key -> (строка)

Ключ S3 объекта S3.

Это обязательно при использовании для следующих целей:

  • IconS3Location (Действия: CreateApplication и UpdateApplication)
  • SessionScriptS3Location (Действия: CreateFleet и UpdateFleet)
  • ScriptDetails (Действия: CreateAppBlock)
  • SourceS3Location при создании блока приложения с типом упаковки CUSTOM (Действия: CreateAppBlock)
  • SourceS3Location при создании блока приложения с типом упаковки APPSTREAM2, и использовании существующего пакета приложения (файл VHD). В этом случае S3Key относится к файлу VHD. Если требуется новый пакет приложения, то S3Key не требуется. (Действия: CreateAppBlock)

ExecutablePath -> (строка)

Путь выполнения скрипта.

ExecutableParameters -> (строка)

Параметры выполнения, передаваемые пути выполнения скрипта.

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

Таймаут выполнения скрипта в секундах.

Краткая форма синтаксиса:

ScriptS3Location={S3Bucket=string,S3Key=string},ExecutablePath=string,ExecutableParameters=string,TimeoutInSeconds=integer

Синтаксис JSON:

{
  "ScriptS3Location": {
    "S3Bucket": "string",
    "S3Key": "string"
  },
  "ExecutablePath": "string",
  "ExecutableParameters": "string",
  "TimeoutInSeconds": integer
}

--tags (массив)

Теги, назначенные блоку приложения.

key -> (строка)

value -> (строка)

Краткая форма синтаксиса:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--post-setup-script-details (структура)

Подробности скрипта пост-настройки блока приложения. Это может быть предоставлено только для типа упаковки APPSTREAM2.

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

Местоположение объекта S3 для скрипта.

S3Bucket -> (строка)

Ведро S3 объекта S3.

S3Key -> (строка)

Ключ S3 объекта S3.

Это обязательно при использовании для следующих целей:

  • IconS3Location (Действия: CreateApplication и UpdateApplication)
  • SessionScriptS3Location (Действия: CreateFleet и UpdateFleet)
  • ScriptDetails (Действия: CreateAppBlock)
  • SourceS3Location при создании блока приложения с типом упаковки CUSTOM (Действия: CreateAppBlock)
  • SourceS3Location при создании блока приложения с типом упаковки APPSTREAM2, и использовании существующего пакета приложения (файл VHD). В этом случае S3Key относится к файлу VHD. Если требуется новый пакет приложения, то S3Key не требуется. (Действия: CreateAppBlock)

ExecutablePath -> (строка)

Путь выполнения скрипта.

ExecutableParameters -> (строка)

Параметры выполнения, передаваемые пути выполнения скрипта.

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

Таймаут выполнения скрипта в секундах.

Краткая форма синтаксиса:

ScriptS3Location={S3Bucket=string,S3Key=string},ExecutablePath=string,ExecutableParameters=string,TimeoutInSeconds=integer

Синтаксис JSON:

{
  "ScriptS3Location": {
    "S3Bucket": "string",
    "S3Key": "string"
  },
  "ExecutablePath": "string",
  "ExecutableParameters": "string",
  "TimeoutInSeconds": integer
}

--packaging-type (строка)

Тип упаковки блока приложения.

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

  • CUSTOM
  • APPSTREAM2

--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-поток

--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-auto-prompt (логическое значение)

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

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

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

Вывод

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

Блок приложения.

Имя -> (строка)

Имя блока приложения.

Arn -> (строка)

ARN блока приложения.

Описание -> (строка)

Описание блока приложения.

Имя для отображения -> (строка)

Имя для отображения блока приложения.

Расположение источника S3 -> (структура)

Расположение источника S3 блока приложения.

S3Bucket -> (строка)

Ведро S3 объекта.

S3Key -> (строка)

Ключ S3 объекта.

Это требуется при использовании для следующих:

  • Расположение S3 иконки (Действия: CreateApplication и UpdateApplication)
  • Расположение S3 скрипта сессии (Действия: CreateFleet и UpdateFleet)
  • Детали скрипта (Действия: CreateAppBlock)
  • Расположение источника S3 при создании блока приложения с типом упаковки CUSTOM (Действия: CreateAppBlock)
  • Расположение источника S3 при создании блока приложения с типом упаковки APPSTREAM2 и использовании существующего пакета приложения (файл VHD). В этом случае, S3Key относится к файлу VHD. Если требуется новый пакет приложения, то S3Key не требуется. (Действия: CreateAppBlock)

Детали скрипта настройки -> (структура)

Детали скрипта настройки блока приложения.

Это относится только к блокам приложений с типом упаковки CUSTOM.

Расположение скрипта в S3 -> (структура)

Расположение объекта S3 для скрипта.

S3Bucket -> (строка)

Ведро S3 объекта.

S3Key -> (строка)

Ключ S3 объекта.

Это требуется при использовании для следующих:

  • Расположение S3 иконки (Действия: CreateApplication и UpdateApplication)
  • Расположение S3 скрипта сессии (Действия: CreateFleet и UpdateFleet)
  • Детали скрипта (Действия: CreateAppBlock)
  • Расположение источника S3 при создании блока приложения с типом упаковки CUSTOM (Действия: CreateAppBlock)
  • Расположение источника S3 при создании блока приложения с типом упаковки APPSTREAM2 и использовании существующего пакета приложения (файл VHD). В этом случае, S3Key относится к файлу VHD. Если требуется новый пакет приложения, то S3Key не требуется. (Действия: CreateAppBlock)

Путь к исполняемому файлу -> (строка)

Путь запуска скрипта.

Параметры исполняемого файла -> (строка)

Параметры выполнения, передаваемые пути запуска скрипта.

Время ожидания (в секундах) -> (целое число)

Время ожидания запуска скрипта в секундах.

Время создания -> (временная метка)

Время создания блока приложения.

Детали скрипта после настройки -> (структура)

Детали скрипта после настройки блока приложения.

Это относится только к блокам приложений с типом упаковки APPSTREAM2.

Расположение скрипта в S3 -> (структура)

Расположение объекта S3 для скрипта.

S3Bucket -> (строка)

Ведро S3 объекта.

S3Key -> (строка)

Ключ S3 объекта.

Это требуется при использовании для следующих:

  • Расположение S3 иконки (Действия: CreateApplication и UpdateApplication)
  • Расположение S3 скрипта сессии (Действия: CreateFleet и UpdateFleet)
  • Детали скрипта (Действия: CreateAppBlock)
  • Расположение источника S3 при создании блока приложения с типом упаковки CUSTOM (Действия: CreateAppBlock)
  • Расположение источника S3 при создании блока приложения с типом упаковки APPSTREAM2 и использовании существующего пакета приложения (файл VHD). В этом случае, S3Key относится к файлу VHD. Если требуется новый пакет приложения, то S3Key не требуется. (Действия: CreateAppBlock)

Путь к исполняемому файлу -> (строка)

Путь запуска скрипта.

Параметры исполняемого файла -> (строка)

Параметры выполнения, передаваемые пути запуска скрипта.

Время ожидания (в секундах) -> (целое число)

Время ожидания запуска скрипта в секундах.

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

Тип упаковки блока приложения.

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

Состояние блока приложения.

Блок приложения с упаковкой AppStream 2.0 будет в состоянии INACTIVE, если к нему не назначен пакет приложения (VHD). После создания пакета приложения (VHD) создателем блока приложения, он становится ACTIVE.

Пользовательские блоки приложений всегда находятся в состоянии ACTIVE, и для их использования не требуется никаких действий.

Ошибки блока приложения -> (список)

Ошибки блока приложения.

(структура)

Подробности об ошибке.

Код ошибки -> (строка)

Код ошибки.

Сообщение об ошибке -> (строка)

Сообщение об ошибке.

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

Spec-Zone.ru

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