AppStreamClient

Amazon AppStream 2.0

This is the Amazon AppStream 2.0 API Reference. This documentation provides descriptions and syntax for each of the actions and data types in AppStream 2.0. AppStream 2.0 is a fully managed, secure application streaming service that lets you stream desktop applications to users without rewriting applications. AppStream 2.0 manages the AWS resources that are required to host and run your applications, scales automatically, and provides access to your users on demand.

You can call the AppStream 2.0 API operations by using an interface VPC endpoint (interface endpoint). For more information, see Access AppStream 2.0 API Operations and CLI Commands Through an Interface VPC Endpoint in the Amazon AppStream 2.0 Administration Guide.

To learn more about AppStream 2.0, see the following resources:

Properties

Link copied to clipboard
abstract override val config: AppStreamClient.Config

AppStreamClient's configuration

Functions

Link copied to clipboard

Associates the specified app block builder with the specified app block.

Link copied to clipboard

Associates the specified application with the specified fleet. This is only supported for Elastic fleets.

Link copied to clipboard

Associates the specified fleet with the specified stack.

Link copied to clipboard

Associates the specified users with the specified stacks. Users in a user pool cannot be assigned to stacks with fleets that are joined to an Active Directory domain.

Link copied to clipboard

Disassociates the specified users from the specified stacks.

Link copied to clipboard
abstract suspend fun copyImage(input: CopyImageRequest): CopyImageResponse

Copies the image within the same region or to a new region within the same AWS account. Note that any tags you added to the image will not be copied.

Link copied to clipboard

Creates an app block.

Link copied to clipboard

Creates an app block builder.

Link copied to clipboard

Creates a URL to start a create app block builder streaming session.

Link copied to clipboard

Creates an application.

Link copied to clipboard

Creates a Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

Link copied to clipboard

Creates a new entitlement. Entitlements control access to specific applications within a stack, based on user attributes. Entitlements apply to SAML 2.0 federated user identities. Amazon AppStream 2.0 user pool and streaming URL users are entitled to all applications in a stack. Entitlements don't apply to the desktop stream view application, or to applications managed by a dynamic app provider using the Dynamic Application Framework.

Link copied to clipboard
abstract suspend fun createFleet(input: CreateFleetRequest): CreateFleetResponse

Creates a fleet. A fleet consists of streaming instances that your users access for their applications and desktops.

Link copied to clipboard

Creates an image builder. An image builder is a virtual machine that is used to create an image.

Link copied to clipboard

Creates a URL to start an image builder streaming session.

Link copied to clipboard
abstract suspend fun createStack(input: CreateStackRequest): CreateStackResponse

Creates a stack to start streaming applications to users. A stack consists of an associated fleet, user access policies, and storage configurations.

Link copied to clipboard

Creates a temporary URL to start an AppStream 2.0 streaming session for the specified user. A streaming URL enables application streaming to be tested without user setup.

Link copied to clipboard

Creates custom branding that customizes the appearance of the streaming application catalog page.

Link copied to clipboard

Creates a new image with the latest Windows operating system updates, driver updates, and AppStream 2.0 agent software.

Link copied to clipboard
abstract suspend fun createUsageReportSubscription(input: CreateUsageReportSubscriptionRequest = CreateUsageReportSubscriptionRequest { }): CreateUsageReportSubscriptionResponse

Creates a usage report subscription. Usage reports are generated daily.

Link copied to clipboard
abstract suspend fun createUser(input: CreateUserRequest): CreateUserResponse

Creates a new user in the user pool.

Link copied to clipboard

Deletes an app block.

Link copied to clipboard

Deletes an app block builder.

Link copied to clipboard

Deletes an application.

Link copied to clipboard

Deletes the specified Directory Config object from AppStream 2.0. This object includes the information required to join streaming instances to an Active Directory domain.

Link copied to clipboard

Deletes the specified entitlement.

Link copied to clipboard
abstract suspend fun deleteFleet(input: DeleteFleetRequest): DeleteFleetResponse

Deletes the specified fleet.

Link copied to clipboard
abstract suspend fun deleteImage(input: DeleteImageRequest): DeleteImageResponse

Deletes the specified image. You cannot delete an image when it is in use. After you delete an image, you cannot provision new capacity using the image.

Link copied to clipboard

Deletes the specified image builder and releases the capacity.

Link copied to clipboard

Deletes permissions for the specified private image. After you delete permissions for an image, AWS accounts to which you previously granted these permissions can no longer use the image.

Link copied to clipboard
abstract suspend fun deleteStack(input: DeleteStackRequest): DeleteStackResponse

Deletes the specified stack. After the stack is deleted, the application streaming environment provided by the stack is no longer available to users. Also, any reservations made for application streaming sessions for the stack are released.

Link copied to clipboard

Deletes custom branding that customizes the appearance of the streaming application catalog page.

Link copied to clipboard
abstract suspend fun deleteUsageReportSubscription(input: DeleteUsageReportSubscriptionRequest = DeleteUsageReportSubscriptionRequest { }): DeleteUsageReportSubscriptionResponse

Disables usage report generation.

Link copied to clipboard
abstract suspend fun deleteUser(input: DeleteUserRequest): DeleteUserResponse

Deletes a user from the user pool.

Retrieves a list that describes one or more app block builder associations.

Link copied to clipboard
abstract suspend fun describeAppBlockBuilders(input: DescribeAppBlockBuildersRequest = DescribeAppBlockBuildersRequest { }): DescribeAppBlockBuildersResponse

Retrieves a list that describes one or more app block builders.

Link copied to clipboard
abstract suspend fun describeAppBlocks(input: DescribeAppBlocksRequest = DescribeAppBlocksRequest { }): DescribeAppBlocksResponse

Retrieves a list that describes one or more app blocks.

Link copied to clipboard
abstract suspend fun describeApplicationFleetAssociations(input: DescribeApplicationFleetAssociationsRequest = DescribeApplicationFleetAssociationsRequest { }): DescribeApplicationFleetAssociationsResponse

Retrieves a list that describes one or more application fleet associations. Either ApplicationArn or FleetName must be specified.

Link copied to clipboard
abstract suspend fun describeApplications(input: DescribeApplicationsRequest = DescribeApplicationsRequest { }): DescribeApplicationsResponse

Retrieves a list that describes one or more applications.

Link copied to clipboard
abstract suspend fun describeDirectoryConfigs(input: DescribeDirectoryConfigsRequest = DescribeDirectoryConfigsRequest { }): DescribeDirectoryConfigsResponse

Retrieves a list that describes one or more specified Directory Config objects for AppStream 2.0, if the names for these objects are provided. Otherwise, all Directory Config objects in the account are described. These objects include the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

Link copied to clipboard

Retrieves a list that describes one of more entitlements.

Link copied to clipboard
abstract suspend fun describeFleets(input: DescribeFleetsRequest = DescribeFleetsRequest { }): DescribeFleetsResponse

Retrieves a list that describes one or more specified fleets, if the fleet names are provided. Otherwise, all fleets in the account are described.

Link copied to clipboard
abstract suspend fun describeImageBuilders(input: DescribeImageBuildersRequest = DescribeImageBuildersRequest { }): DescribeImageBuildersResponse

Retrieves a list that describes one or more specified image builders, if the image builder names are provided. Otherwise, all image builders in the account are described.

Link copied to clipboard

Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own.

Link copied to clipboard
abstract suspend fun describeImages(input: DescribeImagesRequest = DescribeImagesRequest { }): DescribeImagesResponse

Retrieves a list that describes one or more specified images, if the image names or image ARNs are provided. Otherwise, all images in the account are described.

Link copied to clipboard

Retrieves a list that describes the streaming sessions for a specified stack and fleet. If a UserId is provided for the stack and fleet, only streaming sessions for that user are described. If an authentication type is not provided, the default is to authenticate users using a streaming URL.

Link copied to clipboard
abstract suspend fun describeStacks(input: DescribeStacksRequest = DescribeStacksRequest { }): DescribeStacksResponse

Retrieves a list that describes one or more specified stacks, if the stack names are provided. Otherwise, all stacks in the account are described.

Link copied to clipboard

Retrieves a list that describes the theme for a specified stack. A theme is custom branding that customizes the appearance of the streaming application catalog page.

Link copied to clipboard
abstract suspend fun describeUsageReportSubscriptions(input: DescribeUsageReportSubscriptionsRequest = DescribeUsageReportSubscriptionsRequest { }): DescribeUsageReportSubscriptionsResponse

Retrieves a list that describes one or more usage report subscriptions.

Link copied to clipboard

Retrieves a list that describes one or more specified users in the user pool.

Link copied to clipboard
abstract suspend fun describeUserStackAssociations(input: DescribeUserStackAssociationsRequest = DescribeUserStackAssociationsRequest { }): DescribeUserStackAssociationsResponse

Retrieves a list that describes the UserStackAssociation objects. You must specify either or both of the following:

Link copied to clipboard
abstract suspend fun disableUser(input: DisableUserRequest): DisableUserResponse

Disables the specified user in the user pool. Users can't sign in to AppStream 2.0 until they are re-enabled. This action does not delete the user.

Link copied to clipboard

Disassociates a specified app block builder from a specified app block.

Link copied to clipboard

Disassociates the specified application from the fleet.

Link copied to clipboard

Deletes the specified application from the specified entitlement.

Link copied to clipboard

Disassociates the specified fleet from the specified stack.

Link copied to clipboard
abstract suspend fun enableUser(input: EnableUserRequest): EnableUserResponse

Enables a user in the user pool. After being enabled, users can sign in to AppStream 2.0 and open applications from the stacks to which they are assigned.

Link copied to clipboard

Immediately stops the specified streaming session.

Link copied to clipboard

Retrieves the name of the fleet that is associated with the specified stack.

Link copied to clipboard

Retrieves the name of the stack with which the specified fleet is associated.

Link copied to clipboard

Retrieves a list of entitled applications.

Link copied to clipboard

Retrieves a list of all tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

Link copied to clipboard

Starts an app block builder.

Link copied to clipboard
abstract suspend fun startFleet(input: StartFleetRequest): StartFleetResponse

Starts the specified fleet.

Link copied to clipboard

Starts the specified image builder.

Link copied to clipboard

Stops an app block builder.

Link copied to clipboard
abstract suspend fun stopFleet(input: StopFleetRequest): StopFleetResponse

Stops the specified fleet.

Link copied to clipboard

Stops the specified image builder.

Link copied to clipboard
abstract suspend fun tagResource(input: TagResourceRequest): TagResourceResponse

Adds or overwrites one or more tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

Link copied to clipboard

Disassociates one or more specified tags from the specified AppStream 2.0 resource.

Link copied to clipboard

Updates an app block builder.

Link copied to clipboard

Updates the specified application.

Link copied to clipboard

Updates the specified Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

Link copied to clipboard

Updates the specified entitlement.

Link copied to clipboard
abstract suspend fun updateFleet(input: UpdateFleetRequest = UpdateFleetRequest { }): UpdateFleetResponse

Updates the specified fleet.

Link copied to clipboard

Adds or updates permissions for the specified private image.

Link copied to clipboard
abstract suspend fun updateStack(input: UpdateStackRequest): UpdateStackResponse

Updates the specified fields for the specified stack.

Link copied to clipboard

Updates custom branding that customizes the appearance of the streaming application catalog page.

Inherited functions

Link copied to clipboard

Associates the specified app block builder with the specified app block.

Link copied to clipboard

Associates the specified application with the specified fleet. This is only supported for Elastic fleets.

Link copied to clipboard

Associates the specified fleet with the specified stack.

Link copied to clipboard

Associates the specified users with the specified stacks. Users in a user pool cannot be assigned to stacks with fleets that are joined to an Active Directory domain.

Link copied to clipboard

Disassociates the specified users from the specified stacks.

Link copied to clipboard
expect abstract fun close()
Link copied to clipboard
inline suspend fun AppStreamClient.copyImage(crossinline block: CopyImageRequest.Builder.() -> Unit): CopyImageResponse

Copies the image within the same region or to a new region within the same AWS account. Note that any tags you added to the image will not be copied.

Link copied to clipboard

Creates an app block.

Link copied to clipboard

Creates an app block builder.

Link copied to clipboard

Creates a URL to start a create app block builder streaming session.

Link copied to clipboard

Creates an application.

Link copied to clipboard

Creates a Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

Link copied to clipboard

Creates a new entitlement. Entitlements control access to specific applications within a stack, based on user attributes. Entitlements apply to SAML 2.0 federated user identities. Amazon AppStream 2.0 user pool and streaming URL users are entitled to all applications in a stack. Entitlements don't apply to the desktop stream view application, or to applications managed by a dynamic app provider using the Dynamic Application Framework.

Link copied to clipboard
inline suspend fun AppStreamClient.createFleet(crossinline block: CreateFleetRequest.Builder.() -> Unit): CreateFleetResponse

Creates a fleet. A fleet consists of streaming instances that your users access for their applications and desktops.

Link copied to clipboard

Creates an image builder. An image builder is a virtual machine that is used to create an image.

Link copied to clipboard

Creates a URL to start an image builder streaming session.

Link copied to clipboard
inline suspend fun AppStreamClient.createStack(crossinline block: CreateStackRequest.Builder.() -> Unit): CreateStackResponse

Creates a stack to start streaming applications to users. A stack consists of an associated fleet, user access policies, and storage configurations.

Link copied to clipboard

Creates a temporary URL to start an AppStream 2.0 streaming session for the specified user. A streaming URL enables application streaming to be tested without user setup.

Link copied to clipboard

Creates custom branding that customizes the appearance of the streaming application catalog page.

Link copied to clipboard

Creates a new image with the latest Windows operating system updates, driver updates, and AppStream 2.0 agent software.

Link copied to clipboard

Creates a usage report subscription. Usage reports are generated daily.

Link copied to clipboard
inline suspend fun AppStreamClient.createUser(crossinline block: CreateUserRequest.Builder.() -> Unit): CreateUserResponse

Creates a new user in the user pool.

Link copied to clipboard

Deletes an app block.

Link copied to clipboard

Deletes an app block builder.

Link copied to clipboard

Deletes an application.

Link copied to clipboard

Deletes the specified Directory Config object from AppStream 2.0. This object includes the information required to join streaming instances to an Active Directory domain.

Link copied to clipboard

Deletes the specified entitlement.

Link copied to clipboard
inline suspend fun AppStreamClient.deleteFleet(crossinline block: DeleteFleetRequest.Builder.() -> Unit): DeleteFleetResponse

Deletes the specified fleet.

Link copied to clipboard
inline suspend fun AppStreamClient.deleteImage(crossinline block: DeleteImageRequest.Builder.() -> Unit): DeleteImageResponse

Deletes the specified image. You cannot delete an image when it is in use. After you delete an image, you cannot provision new capacity using the image.

Link copied to clipboard

Deletes the specified image builder and releases the capacity.

Link copied to clipboard

Deletes permissions for the specified private image. After you delete permissions for an image, AWS accounts to which you previously granted these permissions can no longer use the image.

Link copied to clipboard
inline suspend fun AppStreamClient.deleteStack(crossinline block: DeleteStackRequest.Builder.() -> Unit): DeleteStackResponse

Deletes the specified stack. After the stack is deleted, the application streaming environment provided by the stack is no longer available to users. Also, any reservations made for application streaming sessions for the stack are released.

Link copied to clipboard

Deletes custom branding that customizes the appearance of the streaming application catalog page.

Link copied to clipboard
Link copied to clipboard
inline suspend fun AppStreamClient.deleteUser(crossinline block: DeleteUserRequest.Builder.() -> Unit): DeleteUserResponse

Deletes a user from the user pool.

Retrieves a list that describes one or more app block builder associations.

Link copied to clipboard

Retrieves a list that describes one or more app block builders.

Link copied to clipboard

Retrieves a list that describes one or more app blocks.

Link copied to clipboard

Retrieves a list that describes one or more application fleet associations. Either ApplicationArn or FleetName must be specified.

Link copied to clipboard

Retrieves a list that describes one or more applications.

Link copied to clipboard

Retrieves a list that describes one or more specified Directory Config objects for AppStream 2.0, if the names for these objects are provided. Otherwise, all Directory Config objects in the account are described. These objects include the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

Link copied to clipboard

Retrieves a list that describes one of more entitlements.

Link copied to clipboard

Retrieves a list that describes one or more specified fleets, if the fleet names are provided. Otherwise, all fleets in the account are described.

Link copied to clipboard

Retrieves a list that describes one or more specified image builders, if the image builder names are provided. Otherwise, all image builders in the account are described.

Link copied to clipboard

Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own.

Link copied to clipboard

Retrieves a list that describes one or more specified images, if the image names or image ARNs are provided. Otherwise, all images in the account are described.

Link copied to clipboard

Retrieves a list that describes the streaming sessions for a specified stack and fleet. If a UserId is provided for the stack and fleet, only streaming sessions for that user are described. If an authentication type is not provided, the default is to authenticate users using a streaming URL.

Link copied to clipboard

Retrieves a list that describes one or more specified stacks, if the stack names are provided. Otherwise, all stacks in the account are described.

Link copied to clipboard

Retrieves a list that describes the theme for a specified stack. A theme is custom branding that customizes the appearance of the streaming application catalog page.

Link copied to clipboard

Retrieves a list that describes one or more usage report subscriptions.

Link copied to clipboard

Retrieves a list that describes one or more specified users in the user pool.

Link copied to clipboard

Retrieves a list that describes the UserStackAssociation objects. You must specify either or both of the following:

Link copied to clipboard
inline suspend fun AppStreamClient.disableUser(crossinline block: DisableUserRequest.Builder.() -> Unit): DisableUserResponse

Disables the specified user in the user pool. Users can't sign in to AppStream 2.0 until they are re-enabled. This action does not delete the user.

Link copied to clipboard

Disassociates a specified app block builder from a specified app block.

Link copied to clipboard

Disassociates the specified application from the fleet.

Link copied to clipboard

Deletes the specified application from the specified entitlement.

Link copied to clipboard

Disassociates the specified fleet from the specified stack.

Link copied to clipboard
inline suspend fun AppStreamClient.enableUser(crossinline block: EnableUserRequest.Builder.() -> Unit): EnableUserResponse

Enables a user in the user pool. After being enabled, users can sign in to AppStream 2.0 and open applications from the stacks to which they are assigned.

Link copied to clipboard

Immediately stops the specified streaming session.

Link copied to clipboard

Retrieves the name of the fleet that is associated with the specified stack.

Link copied to clipboard

Retrieves the name of the stack with which the specified fleet is associated.

Link copied to clipboard

Retrieves a list of entitled applications.

Link copied to clipboard

Retrieves a list of all tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

Link copied to clipboard

Starts an app block builder.

Link copied to clipboard
inline suspend fun AppStreamClient.startFleet(crossinline block: StartFleetRequest.Builder.() -> Unit): StartFleetResponse

Starts the specified fleet.

Link copied to clipboard

Starts the specified image builder.

Link copied to clipboard

Stops an app block builder.

Link copied to clipboard
inline suspend fun AppStreamClient.stopFleet(crossinline block: StopFleetRequest.Builder.() -> Unit): StopFleetResponse

Stops the specified fleet.

Link copied to clipboard

Stops the specified image builder.

Link copied to clipboard
inline suspend fun AppStreamClient.tagResource(crossinline block: TagResourceRequest.Builder.() -> Unit): TagResourceResponse

Adds or overwrites one or more tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

Link copied to clipboard

Disassociates one or more specified tags from the specified AppStream 2.0 resource.

Link copied to clipboard

Updates an app block builder.

Link copied to clipboard

Updates the specified application.

Link copied to clipboard

Updates the specified Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

Link copied to clipboard

Updates the specified entitlement.

Link copied to clipboard
inline suspend fun AppStreamClient.updateFleet(crossinline block: UpdateFleetRequest.Builder.() -> Unit): UpdateFleetResponse

Updates the specified fleet.

Link copied to clipboard

Adds or updates permissions for the specified private image.

Link copied to clipboard
inline suspend fun AppStreamClient.updateStack(crossinline block: UpdateStackRequest.Builder.() -> Unit): UpdateStackResponse

Updates the specified fields for the specified stack.

Link copied to clipboard

Updates custom branding that customizes the appearance of the streaming application catalog page.

Link copied to clipboard

Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.