AWS AppStream 2.0 Fleet

This page shows how to write Terraform and CloudFormation for AppStream 2.0 Fleet and write them securely.

aws_appstream_fleet (Terraform)

The Fleet in AppStream 2.0 can be configured in Terraform with the resource name aws_appstream_fleet. The following sections describe how to use the resource and its parameters.

Example Usage from GitHub

An example could not be found in GitHub.

Review your Terraform file for AWS best practices

Shisho Cloud, our free checker to make sure your Terraform configuration follows best practices, is available (beta).


The following arguments are required:

  • compute_capacity - (Required) Configuration block for the desired capacity of the fleet. See below.
  • instance_type - (Required) Instance type to use when launching fleet instances.
  • name - (Required) Unique name for the fleet.

The following arguments are optional:

  • description - (Optional) Description to display.
  • disconnect_timeout_in_seconds - (Optional) Amount of time that a streaming session remains active after users disconnect.
  • display_name - (Optional) Human-readable friendly name for the AppStream fleet.
  • domain_join_info - (Optional) Configuration block for the name of the directory and organizational unit (OU) to use to join the fleet to a Microsoft Active Directory domain. See below.
  • enable_default_internet_access - (Optional) Enables or disables default internet access for the fleet.
  • fleet_type - (Optional) Fleet type. Valid values are: ON_DEMAND, ALWAYS_ON
  • iam_role_arn - (Optional) ARN of the IAM role to apply to the fleet.
  • idle_disconnect_timeout_in_seconds - (Optional) Amount of time that users can be idle (inactive) before they are disconnected from their streaming session and the disconnect_timeout_in_seconds time interval begins.
  • image_name - (Optional) Name of the image used to create the fleet.
  • image_arn - (Optional) ARN of the public, private, or shared image to use.
  • stream_view - (Optional) AppStream 2.0 view that is displayed to your users when they stream from the fleet. When APP is specified, only the windows of applications opened by users display. When DESKTOP is specified, the standard desktop that is provided by the operating system displays.
  • max_user_duration_in_seconds - (Optional) Maximum amount of time that a streaming session can remain active, in seconds.
  • vpc_config - (Optional) Configuration block for the VPC configuration for the image builder. See below.
  • tags - (Optional) Map of tags to attach to AppStream instances.


  • desired_instances - (Required) Desired number of streaming instances.


  • directory_name - (Optional) Fully qualified name of the directory (for example,
  • organizational_unit_distinguished_name - (Optional) Distinguished name of the organizational unit for computer accounts.


  • security_group_ids - Identifiers of the security groups for the fleet or image builder.
  • subnet_ids - Identifiers of the subnets to which a network interface is attached from the fleet instance or image builder instance.

In addition to all arguments above, the following attributes are exported:

  • id - Unique identifier (ID) of the appstream fleet.
  • arn - ARN of the appstream fleet.
  • state - State of the fleet. Can be STARTING, RUNNING, STOPPING or STOPPED
  • created_time - Date and time, in UTC and extended RFC 3339 format, when the fleet was created.
  • compute_capacity - Describes the capacity status for a fleet.

Explanation in Terraform Registry

Provides an AppStream fleet.

AWS::AppStream::Fleet (CloudFormation)

The Fleet in AppStream can be configured in CloudFormation with the resource name AWS::AppStream::Fleet. The following sections describe how to use the resource and its parameters.

Example Usage from GitHub

An example could not be found in GitHub.


Explanation in CloudFormation Registry

The AWS::AppStream::Fleet resource creates a fleet for Amazon AppStream 2.

  1. A fleet consists of streaming instances that run a specified image.

Frequently asked questions

What is AWS AppStream 2.0 Fleet?

AWS AppStream 2.0 Fleet is a resource for AppStream 2.0 of Amazon Web Service. Settings can be wrote in Terraform and CloudFormation.