Spec-Zone.ru › AWS CLI v2

[ aws . appstream ]

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 — единственное допустимое значение.

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

  • WINDOWS
  • WINDOWS_SERVER_2016
  • WINDOWS_SERVER_2019
  • WINDOWS_SERVER_2022
  • AMAZON_LINUX2
  • RHEL8
  • ROCKY_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 -> (строка)

Идентификатор (ID) VPC, в которой используется интерфейсный конечный пункт.

Краткая запись:

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 -> (строка)

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

Name -> (строка)

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

DisplayName -> (строка)

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

Description -> (строка)

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

Platform -> (строка)

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

WINDOWS_SERVER_2019 — единственное допустимое значение.

InstanceType -> (строка)

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

EnableDefaultInternetAccess -> (булево)

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

IamRoleArn -> (строка)

ARN роли IAM, применяемой к создателю блоков приложений.

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 -> (строка)

Идентификатор (ID) VPC, в которой используется интерфейсная точка.

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

Spec-Zone.ru

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