создать-обновлённую-образу
Описание
Создаёт новый образ с последними обновлениями операционной системы 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 (строка)
--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 (логическое значение)
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 -> (строка)
BaseImageArn -> (строка)
DisplayName -> (строка)
Состояние -> (строка)
PENDING. Если создание изображения успешно, состояние становится AVAILABLE. Если создание изображения завершилось ошибкой, состояние становится FAILED.Видимость -> (строка)
Поддерживается Image Builder -> (булево)
Имя Image Builder -> (строка)
Платформа -> (строка)
Описание -> (строка)
Причина изменения состояния -> (структура)
Причина последнего изменения состояния.
Код -> (строка)
Сообщение -> (строка)
Приложения -> (список)
Приложения, связанные с изображением.
(структура)
Описание приложения в каталоге приложений.
Имя -> (строка)
DisplayName -> (строка)
URL значка -> (строка)
Путь запуска -> (строка)
Параметры запуска -> (строка)
Включено -> (булево)
Метаданные -> (отображение)
Дополнительные атрибуты, описывающие приложение.
ключ -> (строка)
значение -> (строка)
Рабочая директория -> (строка)
Описание -> (строка)
Arn -> (строка)
Arn блока приложений -> (строка)
Расположение значка в S3 -> (структура)
Расположение значка приложения в S3.
Ведро S3 -> (строка)
Ключ S3 -> (строка)
Ключ объекта в S3.
Это требуется в следующих случаях:
- IconS3Location (Действия: CreateApplication и UpdateApplication)
- SessionScriptS3Location (Действия: CreateFleet и UpdateFleet)
- ScriptDetails (Действия: CreateAppBlock)
- SourceS3Location при создании блока приложений с
CUSTOMPackagingType (Действия: CreateAppBlock) - SourceS3Location при создании блока приложений с
APPSTREAM2PackagingType и использовании существующего пакета приложений (файл VHD). В этом случаеS3Keyотносится к файлу VHD. Если требуется новый пакет приложений, тоS3Keyне требуется. (Действия: CreateAppBlock)
Платформы -> (список)
Платформы, на которых может работать приложение.
(строка)
Семейства экземпляров -> (список)
Семейства экземпляров для приложения.
(строка)
Время создания -> (метка времени)
Время создания -> (метка времени)
Дата выпуска общедоступного базового изображения -> (метка времени)
Версия агента AppStream 2.0 -> (строка)
Разрешения изображения -> (структура)
Разрешения, предоставляемые целевому учетной записи AWS для указанного изображения.
Разрешение для флота -> (булево)
Разрешение для Image Builder -> (булево)
Ошибки изображения -> (список)
Описание ошибок, возвращаемых при невозможности создания нового изображения.
(структура)
Описание ошибки ресурса.
Код ошибки -> (строка)
Сообщение об ошибке -> (строка)
Время ошибки -> (метка времени)
Последняя версия агента Appstream -> (строка)
Поддерживаемые семейства экземпляров -> (список)
Поддерживаемые семейства экземпляров, определяющие, какое изображение клиент может использовать при запуске флота или Image Builder. Поддерживаются следующие семейства экземпляров:
- Общего назначения
- Оптимизированные под вычисления
- Оптимизированные под память
- Графика
- Графический дизайн
- Графический Pro
- Графический G4
- Графический G5
(строка)
Включены динамические поставщики приложений -> (строка)
Изображение разделено с другими учетными записями -> (строка)
можно обновить изображение -> (булево)
© Copyright 2025, Amazon Web Services. Created using Sphinx.