Spec-Zone.ru › AWS CLI v2

[ aws . appstream ]

создать-обновлённую-образу

Описание

Создаёт новый образ с последними обновлениями операционной системы Windows, обновлениями драйверов и программным обеспечением агента AppStream 2.0.

Для получения дополнительной информации см. раздел «Обновление образа с помощью обновлений управляемых образов AppStream 2.0» в руководстве по администрированию Amazon AppStream 2.0.

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

Синтаксис

  create-updated-image
--existing-image-name <value>
--new-image-name <value>
[--new-image-description <value>]
[--new-image-display-name <value>]
[--new-image-tags <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

--existing-image-name (строка)

Название образа для обновления.

--new-image-name (строка)

Название нового образа. Название должно быть уникальным в рамках AWS-аккаунта и региона.

--new-image-description (строка)

Описание, отображаемое для нового образа.

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

Название, отображаемое для нового образа.

--new-image-tags (карта)

Теги, которые нужно добавить к новому образу. Тег — это пара ключ-значение, где значение необязательно. Например, Environment=Test. Если значение не указано, то Environment=.

Допускаются в основном следующие символы: буквы, цифры и пробелы, отображаемые в UTF-8, а также следующие специальные символы:

_ . : / = + - @

Если значение не указано, оно устанавливается в пустую строку.

Для получения дополнительной информации о тегах см. раздел «Добавление тегов к ресурсам» в руководстве по администрированию Amazon AppStream 2.0.

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

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

Сокращенный синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--dry-run | --no-dry-run (логическое значение)

Указывает, нужно ли отобразить состояние доступности обновления образа перед тем, как AppStream 2.0 начнёт процесс создания нового обновлённого образа. Если значение равно true, AppStream 2.0 отображает, доступны ли обновления образа. Если значение равно false, AppStream 2.0 запускает процесс создания нового обновлённого образа без отображения доступности обновлений образа.

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

Вывод

изображение -> (структура)

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

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

Имя изображения.

Arn -> (строка)

ARN изображения.

BaseImageArn -> (строка)

ARN изображения, из которого было создано это изображение.

DisplayName -> (строка)

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

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

Изображение начинает работу в состоянии PENDING. Если создание изображения успешно, состояние становится AVAILABLE. Если создание изображения завершилось ошибкой, состояние становится FAILED.

Видимость -> (строка)

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

Поддерживается Image Builder -> (булево)

Указывает, можно ли запустить Image Builder из этого изображения.

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

Имя Image Builder, которое использовалось для создания закрытого изображения. Если изображение совместное, это значение равно null.

Платформа -> (строка)

Платформа операционной системы изображения.

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

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

Причина изменения состояния -> (структура)

Причина последнего изменения состояния.

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

Код причины изменения состояния.

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

Сообщение причины изменения состояния.

Приложения -> (список)

Приложения, связанные с изображением.

(структура)

Описание приложения в каталоге приложений.

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

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

DisplayName -> (строка)

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

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

URL значка приложения. Этот URL может быть ограничен по времени.

Путь запуска -> (строка)

Путь к исполняемому файлу приложения в экземпляре.

Параметры запуска -> (строка)

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

Включено -> (булево)

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

Метаданные -> (отображение)

Дополнительные атрибуты, описывающие приложение.

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

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

Рабочая директория -> (строка)

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

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

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

Arn -> (строка)

ARN приложения.

Arn блока приложений -> (строка)

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

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

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

Ведро S3 -> (строка)

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

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

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

Это требуется в следующих случаях:

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

Платформы -> (список)

Платформы, на которых может работать приложение.

(строка)

Семейства экземпляров -> (список)

Семейства экземпляров для приложения.

(строка)

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

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

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

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

Дата выпуска общедоступного базового изображения -> (метка времени)

Дата выпуска общедоступного базового изображения. Для закрытых изображений это дата выпуска базового изображения, из которого было создано изображение.

Версия агента AppStream 2.0 -> (строка)

Версия агента AppStream 2.0 для использования в экземплярах, запущенных из этого изображения.

Разрешения изображения -> (структура)

Разрешения, предоставляемые целевому учетной записи AWS для указанного изображения.

Разрешение для флота -> (булево)

Указывает, можно ли использовать изображение для флота.

Разрешение для Image Builder -> (булево)

Указывает, можно ли использовать изображение для Image Builder.

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

Описание ошибок, возвращаемых при невозможности создания нового изображения.

(структура)

Описание ошибки ресурса.

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

Код ошибки.

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

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

Время ошибки -> (метка времени)

Время возникновения ошибки.

Последняя версия агента Appstream -> (строка)

Указывает, использует ли изображение последнюю версию агента AppStream 2.0 или нет.

Поддерживаемые семейства экземпляров -> (список)

Поддерживаемые семейства экземпляров, определяющие, какое изображение клиент может использовать при запуске флота или Image Builder. Поддерживаются следующие семейства экземпляров:

  • Общего назначения
  • Оптимизированные под вычисления
  • Оптимизированные под память
  • Графика
  • Графический дизайн
  • Графический Pro
  • Графический G4
  • Графический G5

(строка)

Включены динамические поставщики приложений -> (строка)

Указывает, включены ли динамические поставщики приложений в изображении AppStream 2.0 или нет.

Изображение разделено с другими учетными записями -> (строка)

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

можно обновить изображение -> (булево)

Указывает, можно ли создать новое изображение.

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

Spec-Zone.ru

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