update-app-block-builder
Описание
Обновляет билдер блоков приложений.
Если билдер блоков приложений находится в состоянии STARTING или STOPPING, его нельзя обновить. Если билдер блоков приложений находится в состоянии RUNNING, можно обновить только DisplayName и Description. Если билдер блоков приложений находится в состоянии STOPPED, можно обновить любой атрибут, кроме Name.
См. также: Документацию API AWS
Синтаксис
update-app-block-builder
--name <value>
[--description <value>]
[--display-name <value>]
[--platform <value>]
[--instance-type <value>]
[--vpc-config <value>]
[--enable-default-internet-access | --no-enable-default-internet-access]
[--iam-role-arn <value>]
[--access-endpoints <value>]
[--attributes-to-delete <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 (строка)
--platform (строка)
Платформа билдера блоков приложений.
WINDOWS_SERVER_2019 — единственное допустимое значение.Возможные значения:
WINDOWSWINDOWS_SERVER_2016WINDOWS_SERVER_2019WINDOWS_SERVER_2022AMAZON_LINUX2RHEL8ROCKY_LINUX8
--instance-type (строка)
Тип экземпляра, который нужно использовать при запуске билдера блоков приложений. Доступны следующие типы экземпляров:
- stream.standard.small
- stream.standard.medium
- stream.standard.large
- stream.standard.xlarge
- stream.standard.2xlarge
--vpc-config (структура)
Настройка VPC для билдера блоков приложений.
Билдерам блоков приложений необходимо указать как минимум две подсети в разных зонах доступности.
SubnetIds -> (список)
Идентификаторы подсетей, к которым подключен сетевой интерфейс с экземпляра флекса или экземпляра билдера образов. Экземпляры флекса используют одну или несколько подсетей. Экземпляры билдеров образов используют одну подсеть.
(строка)
SecurityGroupIds -> (список)
Идентификаторы групп безопасности для флекса или билдера образов.
(строка)
Краткая запись:
SubnetIds=string,string,SecurityGroupIds=string,string
Синтаксис JSON:
{
"SubnetIds": ["string", ...],
"SecurityGroupIds": ["string", ...]
}
--enable-default-internet-access | --no-enable-default-internet-access (логическое значение)
--iam-role-arn (строка)
Amazon Resource Name (ARN) роли IAM, которая должна применяться к билдеру блоков приложений. Для доверенного доступа билдер блоков приложений вызывает операцию API AWS Security Token Service (STS) AssumeRole и передает ARN используемой роли. Данная операция создает новую сессию с временными учетными данными. AppStream 2.0 получает временные учетные данные и создает профиль учетных данных appstream_machine_role на экземпляре.
Дополнительную информацию см. в разделе Использование роли IAM для предоставления разрешений приложениям и скриптам, выполняемым на экземплярах потоковой передачи AppStream 2.0, в руководстве Amazon AppStream 2.0 Administration Guide.
--access-endpoints (список)
Список объектов интерфейсного конечного пункта VPC (интерфейсного конечного пункта). Администраторы могут подключаться к билдеру блоков приложений только через указанные конечные пункты.
(структура)
Описание интерфейсного конечного пункта VPC (интерфейсного конечного пункта), который позволяет создать частное подключение между заданной вами виртуальной частной сетью (VPC) и AppStream 2.0. Когда вы указываете интерфейсный конечный пункт для стека, пользователи стека могут подключаться к AppStream 2.0 только через этот конечный пункт. Когда вы указываете интерфейсный конечный пункт для билдера образов, администраторы могут подключаться к билдеру образов только через этот конечный пункт.
EndpointType -> (строка)
VpceId -> (строка)
Краткая запись:
EndpointType=string,VpceId=string ...
Синтаксис JSON:
[
{
"EndpointType": "STREAMING",
"VpceId": "string"
}
...
]
--attributes-to-delete (список)
Атрибуты, которые нужно удалить из билдера блоков приложений.
(строка)
Синтаксис:
"string" "string" ...
Where valid values are:
IAM_ROLE_ARN
ACCESS_ENDPOINTS
VPC_CONFIGURATION_SECURITY_GROUP_IDS
--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
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Использовать указанный регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--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.
Вывод
AppBlockBuilder -> (структура)
Описывает создателя блоков приложений.
Arn -> (строка)
Name -> (строка)
DisplayName -> (строка)
Description -> (строка)
Platform -> (строка)
Платформа создателя блоков приложений.
WINDOWS_SERVER_2019 — единственное допустимое значение.InstanceType -> (строка)
EnableDefaultInternetAccess -> (булево)
IamRoleArn -> (строка)
VpcConfig -> (структура)
Настройка VPC для создателя блоков приложений.
SubnetIds -> (список)
Идентификаторы подсетей, к которым подключен сетевой интерфейс от экземпляра флота или экземпляра создателя изображений. Экземпляры флотов используют одну или несколько подсетей. Экземпляры создателей изображений используют одну подсеть.
(строка)
SecurityGroupIds -> (список)
Идентификаторы групп безопасности для флота или создателя изображений.
(строка)
State -> (строка)
CreatedTime -> (метка времени)
AppBlockBuilderErrors -> (список)
Ошибки создателя блоков приложений.
(структура)
Описание ошибки ресурса.
ErrorCode -> (строка)
ErrorMessage -> (строка)
ErrorTimestamp -> (метка времени)
StateChangeReason -> (структура)
Причина изменения состояния.
Code -> (строка)
Message -> (строка)
AccessEndpoints -> (список)
Список объектов интерфейсных VPC-точек (интерфейсных точек). Администраторы могут подключаться к создателю блоков приложений только через указанные точки.
(структура)
Описание интерфейсной VPC-точки (интерфейсной точки), которая позволяет создать частное подключение между указанной виртуальной частной областью (VPC) и AppStream 2.0. При указании интерфейсной точки для стека пользователи стека могут подключаться к AppStream 2.0 только через эту точку. При указании интерфейсной точки для создателя изображений администраторы могут подключаться к создателю изображений только через эту точку.
EndpointType -> (строка)
VpceId -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.