create-fleet

Описание

Создаёт флот. Флот состоит из потоковых экземпляров, к которым ваши пользователи получают доступ для своих приложений и рабочих столов.

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

Синтаксис

  create-fleet
--name <value>
[--image-name <value>]
[--image-arn <value>]
--instance-type <value>
[--fleet-type <value>]
[--compute-capacity <value>]
[--vpc-config <value>]
[--max-user-duration-in-seconds <value>]
[--disconnect-timeout-in-seconds <value>]
[--description <value>]
[--display-name <value>]
[--enable-default-internet-access | --no-enable-default-internet-access]
[--domain-join-info <value>]
[--tags <value>]
[--idle-disconnect-timeout-in-seconds <value>]
[--iam-role-arn <value>]
[--stream-view <value>]
[--platform <value>]
[--max-concurrent-sessions <value>]
[--usb-device-filter-strings <value>]
[--session-script-s3-location <value>]
[--max-sessions-per-instance <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 (строка)

Уникальное имя для флота.

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

Имя образа, используемого для создания флота.

--image-arn (строка)

ARN публичного, частного или общего образа для использования.

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

Тип экземпляра, используемого при запуске экземпляров флота. Доступны следующие типы экземпляров:

stream.standard.small
stream.standard.medium
stream.standard.large
stream.standard.xlarge
stream.standard.2xlarge
stream.compute.large
stream.compute.xlarge
stream.compute.2xlarge
stream.compute.4xlarge
stream.compute.8xlarge
stream.memory.large
stream.memory.xlarge
stream.memory.2xlarge
stream.memory.4xlarge
stream.memory.8xlarge
stream.memory.z1d.large
stream.memory.z1d.xlarge
stream.memory.z1d.2xlarge
stream.memory.z1d.3xlarge
stream.memory.z1d.6xlarge
stream.memory.z1d.12xlarge
stream.graphics-design.large
stream.graphics-design.xlarge
stream.graphics-design.2xlarge
stream.graphics-design.4xlarge
stream.graphics-desktop.2xlarge
stream.graphics.g4dn.xlarge
stream.graphics.g4dn.2xlarge
stream.graphics.g4dn.4xlarge
stream.graphics.g4dn.8xlarge
stream.graphics.g4dn.12xlarge
stream.graphics.g4dn.16xlarge
stream.graphics.g5.xlarge
stream.graphics.g5.2xlarge
stream.graphics.g5.4xlarge
stream.graphics.g5.8xlarge
stream.graphics.g5.12xlarge
stream.graphics.g5.16xlarge
stream.graphics.g5.24xlarge
stream.graphics-pro.4xlarge
stream.graphics-pro.8xlarge
stream.graphics-pro.16xlarge

Следующие типы экземпляров доступны для упругих флотов:

stream.standard.small
stream.standard.medium
stream.standard.large
stream.standard.xlarge
stream.standard.2xlarge

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

Тип флота.

ALWAYS_ON

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

ON_DEMAND

Предоставляет пользователям доступ к приложениям после подключения, что занимает одну-две минуты. Вы оплачиваете трансляцию экземпляров, когда пользователи подключены, и небольшую ежечасовую плату за экземпляры, которые не транслируют приложения.

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

ALWAYS_ON
ON_DEMAND
ELASTIC

--compute-capacity (структура)

Желаемая ёмкость для флота. Это не разрешено для упругих флотов. Для упругих флотов укажите MaxConcurrentSessions.

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

Желаемое число потоковых экземпляров.

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

Желаемое число сеансов пользователей для многосеансового флота. Это не разрешено для односеансовых флотов.

При создании флота необходимо указать либо атрибут DesiredSessions, либо DesiredInstances, в зависимости от типа создаваемого флота. Вы не можете определить оба атрибута или оставить оба атрибута пустыми.

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

DesiredInstances=integer,DesiredSessions=integer

Синтаксис JSON:

{
  "DesiredInstances": integer,
  "DesiredSessions": integer
}

--vpc-config (структура)

Настройка VPC для флота. Это необходимо для упругих флотов, но не обязательно для других типов флотов. Для упругих флотов требуется указать как минимум две подсети в разных зонах доступности.

SubnetIds -> (список)

Идентификаторы подсетей, к которым подключен сетевой интерфейс от экземпляра флота или экземпляра создателя образа. Экземпляры флота используют одну или несколько подсетей. Экземпляры создателя образа используют одну подсеть.

(строка)

SecurityGroupIds -> (список)

Идентификаторы групп безопасности для флота или создателя образа.

(строка)

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

SubnetIds=string,string,SecurityGroupIds=string,string

Синтаксис JSON:

{
  "SubnetIds": ["string", ...],
  "SecurityGroupIds": ["string", ...]
}

--max-user-duration-in-seconds (целое число)

Максимальное время активности сеанса потоковой передачи в секундах. Если пользователи всё ещё подключены к экземпляру потоковой передачи за пять минут до достижения этого предела, им предлагается сохранить все открытые документы перед отключением. По истечении этого времени экземпляр завершается и заменяется новым экземпляром.

Укажите значение от 600 до 432000.

--disconnect-timeout-in-seconds (целое число)

Время, в течение которого сеанс потоковой передачи остаётся активным после отключения пользователей. Если пользователи пытаются повторно подключиться к сеансу потоковой передачи после отключения или сбоя сети в течение этого интервала времени, они подключаются к предыдущему сеансу. В противном случае они подключаются к новому сеансу с новым экземпляром потоковой передачи.

Укажите значение от 60 до 36000.

--description (строка)

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

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

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

--enable-default-internet-access | --no-enable-default-internet-access (логическое значение)

Включает или отключает стандартный доступ в интернет для флота.

--domain-join-info (структура)

Имя каталога и организационной единицы (OU) для присоединения флота к домену Microsoft Active Directory. Это не разрешено для упругих флотов.

DirectoryName -> (строка)

Полное доменное имя каталога (например, corp.example.com).

OrganizationalUnitDistinguishedName -> (строка)

Уникальное имя организационной единицы для учётных записей компьютеров.

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

DirectoryName=string,OrganizationalUnitDistinguishedName=string

Синтаксис JSON:

{
  "DirectoryName": "string",
  "OrganizationalUnitDistinguishedName": "string"
}

--tags (отображение)

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

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

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

_ . : / = + - @

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

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--idle-disconnect-timeout-in-seconds (целое число)

Время, в течение которого пользователи могут быть бездействующими (неактивными), прежде чем они будут отключены от сеанса потоковой передачи, и начнется интервал времени DisconnectTimeoutInSeconds. Пользователи получают уведомление, прежде чем они будут отключены из-за бездействия. Если они пытаются повторно подключиться к сеансу потоковой передачи до истечения интервала времени, указанного в DisconnectTimeoutInSeconds, они подключаются к предыдущему сеансу. Пользователи считаются бездействующими, когда они прекращают ввод с клавиатуры или мыши во время сеанса потоковой передачи. Загрузка и загрузка файлов, ввод и вывод звука, а также изменение пикселей не считаются активностью пользователя. Если пользователи продолжают бездействовать после истечения интервала времени в IdleDisconnectTimeoutInSeconds, они отключаются.

Чтобы предотвратить отключение пользователей из-за бездействия, укажите значение 0. В противном случае укажите значение от 60 до 36000. Значение по умолчанию равно 0.

Примечание

Если вы включите эту функцию, мы рекомендуем указать значение, которое соответствует ровному числу минут (например, 60, 120 и 180). Если вы этого не сделаете, значение округляется до ближайшей минуты. Например, если вы укажете значение 70, пользователи отключаются через 1 минуту бездействия. Если вы укажете значение, которое находится посередине между двумя разными минутами, значение округляется вверх. Например, если вы укажете значение 90, пользователи отключаются через 2 минуты бездействия.

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

--stream-view (строка)

Представление AppStream 2.0, отображаемое пользователям при потоковой передаче из флота. Если указано APP, отображаются только окна приложений, открытых пользователями. Если указано DESKTOP, отображается стандартный рабочий стол, предоставляемый операционной системой.

Значение по умолчанию равно APP.

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

APP
DESKTOP

--platform (строка)

Платформа флота. WINDOWS_SERVER_2019 и AMAZON_LINUX2 поддерживаются для упругих флотов.

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

WINDOWS
WINDOWS_SERVER_2016
WINDOWS_SERVER_2019
WINDOWS_SERVER_2022
AMAZON_LINUX2
RHEL8
ROCKY_LINUX8

--max-concurrent-sessions (целое число)

Максимальное количество одновременных сеансов упругого флота. Это требуется для упругих флотов и не разрешено для других типов флотов.

--usb-device-filter-strings (список)

Строки фильтра устройств USB, которые указывают, какие устройства USB пользователь может перенаправить в сеанс потоковой передачи флота при использовании локального клиента Windows. Это разрешено, но не обязательно для упругих флотов.

(строка)

Синтаксис:

"string" "string" ...

--session-script-s3-location (структура)

Расположение файла конфигурации сценариев сеанса в формате zip в S3. Это относится только к флотам Elastic.

S3Bucket -> (строка)

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

S3Key -> (строка)

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

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

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

Сокращенная синтаксическая запись:

S3Bucket=string,S3Key=string

Синтаксис JSON:

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

--max-sessions-per-instance (целое число)

Максимальное количество пользовательских сеансов на экземпляре. Это относится только к флотам с несколькими сеансами.

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

Amazon Resource Name (ARN) для флота.

Name -> (строка)

Название флота.

DisplayName -> (строка)

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

Description -> (строка)

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

ImageName -> (строка)

Название образа, используемого для создания флота.

ImageArn -> (строка)

ARN для публичного, частного или общего образа.

InstanceType -> (строка)

Тип экземпляра, используемого при запуске экземпляров флота. Доступны следующие типы экземпляров:

stream.standard.small
stream.standard.medium
stream.standard.large
stream.compute.large
stream.compute.xlarge
stream.compute.2xlarge
stream.compute.4xlarge
stream.compute.8xlarge
stream.memory.large
stream.memory.xlarge
stream.memory.2xlarge
stream.memory.4xlarge
stream.memory.8xlarge
stream.memory.z1d.large
stream.memory.z1d.xlarge
stream.memory.z1d.2xlarge
stream.memory.z1d.3xlarge
stream.memory.z1d.6xlarge
stream.memory.z1d.12xlarge
stream.graphics-design.large
stream.graphics-design.xlarge
stream.graphics-design.2xlarge
stream.graphics-design.4xlarge
stream.graphics-desktop.2xlarge
stream.graphics.g4dn.xlarge
stream.graphics.g4dn.2xlarge
stream.graphics.g4dn.4xlarge
stream.graphics.g4dn.8xlarge
stream.graphics.g4dn.12xlarge
stream.graphics.g4dn.16xlarge
stream.graphics-pro.4xlarge
stream.graphics-pro.8xlarge
stream.graphics-pro.16xlarge

FleetType -> (строка)

Тип флота.

ALWAYS_ON

Предоставляет пользователям мгновенный доступ к приложениям. Вы оплачиваете все запущенные экземпляры в вашем флоте, даже если пользователи не транслируют приложения.

ON_DEMAND

Предоставляет пользователям доступ к приложениям после подключения, что занимает от одной до двух минут. Вы оплачиваете трансляцию экземпляров, когда пользователи подключены, и небольшую ежечасовую плату за экземпляры, которые не транслируют приложения.

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

Статус емкости для флота.

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

Желаемое количество экземпляров потоковой передачи.

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

Общее количество одновременно работающих экземпляров потоковой передачи.

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

Количество экземпляров, используемых для потоковой передачи.

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

Количество доступных экземпляров, которые могут быть использованы для потоковой передачи сеансов.

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

Общее количество слотов сеансов, которые либо работают, либо находятся в очереди. Это общее количество одновременных сеансов потоковой передачи, которые может поддерживать ваш флот в устойчивом состоянии.

DesiredUserSessionCapacity = ActualUserSessionCapacity + PendingUserSessionCapacity

Это относится только к флотам с несколькими сеансами.

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

Количество свободных слотов сеансов, доступных для пользовательских сеансов.

AvailableUserSessionCapacity = ActualUserSessionCapacity - ActiveUserSessions

Это относится только к флотам с несколькими сеансами.

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

Количество пользовательских сеансов, которые в настоящее время используются для сеансов потоковой передачи. Это относится только к флотам с несколькими сеансами.

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

Общее количество слотов сеансов, доступных для потоковой передачи или в настоящее время осуществляющих потоковую передачу.

ActualUserSessionCapacity = AvailableUserSessionCapacity + ActiveUserSessions

Это относится только к флотам с несколькими сеансами.

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

Максимальное время активности сеанса потоковой передачи в секундах. Если пользователи по-прежнему подключены к экземпляру потоковой передачи за пять минут до достижения этого предела, им предлагается сохранить все открытые документы перед отключением. После истечения этого времени экземпляр завершается и заменяется новым экземпляром.

Укажите значение от 600 до 360000.

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

Время, в течение которого сеанс потоковой передачи остается активным после отключения пользователей. Если они попытаются повторно подключиться к сеансу потоковой передачи после отключения или прерывания сети в течение этого интервала, они подключатся к своему предыдущему сеансу. В противном случае они подключатся к новому сеансу с новым экземпляром потоковой передачи.

Укажите значение от 60 до 36000.

State -> (строка)

Текущее состояние флота.

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

Настройка VPC для флота.

SubnetIds -> (список)

Идентификаторы подсетей, к которым прикреплен сетевой интерфейс от экземпляра флота или экземпляра создателя образа. Экземпляры флота используют одну или несколько подсетей. Экземпляры создателей образов используют одну подсеть.

(строка)

SecurityGroupIds -> (список)

Идентификаторы групп безопасности для флота или создателя образов.

(строка)

CreatedTime -> (метка времени)

Время создания флота.

FleetErrors -> (список)

Ошибки флота.

(структура)

Описание ошибки флота.

ErrorCode -> (строка)

Код ошибки.

ErrorMessage -> (строка)

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

EnableDefaultInternetAccess -> (булево)

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

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

Имя каталога и организационной единицы (OU) для подключения флота к домену Microsoft Active Directory.

DirectoryName -> (строка)

Полное доменное имя каталога (например, corp.example.com).

OrganizationalUnitDistinguishedName -> (строка)

Отличительное имя организационной единицы для учетных записей компьютеров.

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

Время, в течение которого пользователи могут быть бездействующими (неактивными) перед их отключением от сеанса потоковой передачи и началом интервала времени DisconnectTimeoutInSeconds. Пользователи уведомляются перед отключением из-за бездействия. Если пользователи попытаются повторно подключиться к сеансу потоковой передачи до истечения интервала времени, указанного в DisconnectTimeoutInSeconds, они подключатся к своему предыдущему сеансу. Пользователи считаются бездействующими, когда они прекращают ввод с клавиатуры или мыши во время сеанса потоковой передачи. Загрузка и загрузка файлов, аудиовход, аудиовыход и изменения пикселей не считаются активностью пользователя. Если пользователи продолжают бездействовать после истечения интервала времени в IdleDisconnectTimeoutInSeconds, они отключаются.

Примечание

Если вы включили эту функцию, мы рекомендуем указать значение, которое точно соответствует целому числу минут (например, 60, 120 и 180). Если вы этого не сделаете, значение будет округлено до ближайшей минуты. Например, если вы укажете значение 70, пользователи отключаются через 1 минуту бездействия. Если вы укажете значение, которое находится посередине между двумя разными минутами, значение округляется вверх. Например, если вы укажете значение 90, пользователи отключаются через 2 минуты бездействия.

IamRoleArn -> (строка)

ARN роли IAM, которая применяется к флоту. Для использования роли экземпляр флота вызывает операцию AWS Security Token Service (STS) AssumeRole и передает ARN используемой роли. Операция создает новую сессию с временными учетными данными. AppStream 2.0 извлекает временные учетные данные и создает профиль учетных данных appstream_machine_role на экземпляре.

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

StreamView -> (строка)

Представление AppStream 2.0, отображаемое пользователям при потоковой передаче из флота. Если указано APP, отображаются только окна приложений, открытые пользователями. Если указано DESKTOP, отображается стандартный рабочий стол, предоставляемый операционной системой.

Значение по умолчанию — APP.

Platform -> (строка)

Платформа флота.

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

Максимальное количество одновременных сеансов для флота.

UsbDeviceFilterStrings -> (список)

Строки фильтра USB-устройств, связанные с флотом.

(строка)

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

Расположение скриптов сеансов в S3 в виде zip-файла конфигурации. Это относится только к флотам Elastic.

S3Bucket -> (строка)

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

S3Key -> (строка)

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

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

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

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