@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonAppStreamClient extends AmazonWebServiceClient implements AmazonAppStream
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:
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIX| Constructor and Description |
|---|
AmazonAppStreamClient()
Deprecated.
|
AmazonAppStreamClient(AWSCredentials awsCredentials)
Deprecated.
use
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AmazonAppStreamClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build(); |
AmazonAppStreamClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
|
AmazonAppStreamClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AmazonAppStreamClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AmazonAppStreamClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
|
AmazonAppStreamClient(ClientConfiguration clientConfiguration)
Deprecated.
|
| Modifier and Type | Method and Description |
|---|---|
AssociateFleetResult |
associateFleet(AssociateFleetRequest request)
Associates the specified fleet with the specified stack.
|
BatchAssociateUserStackResult |
batchAssociateUserStack(BatchAssociateUserStackRequest request)
Associates the specified users with the specified stacks.
|
BatchDisassociateUserStackResult |
batchDisassociateUserStack(BatchDisassociateUserStackRequest request)
Disassociates the specified users from the specified stacks.
|
static AmazonAppStreamClientBuilder |
builder() |
CopyImageResult |
copyImage(CopyImageRequest request)
Copies the image within the same region or to a new region within the same AWS account.
|
CreateDirectoryConfigResult |
createDirectoryConfig(CreateDirectoryConfigRequest request)
Creates a Directory Config object in AppStream 2.0.
|
CreateFleetResult |
createFleet(CreateFleetRequest request)
Creates a fleet.
|
CreateImageBuilderResult |
createImageBuilder(CreateImageBuilderRequest request)
Creates an image builder.
|
CreateImageBuilderStreamingURLResult |
createImageBuilderStreamingURL(CreateImageBuilderStreamingURLRequest request)
Creates a URL to start an image builder streaming session.
|
CreateStackResult |
createStack(CreateStackRequest request)
Creates a stack to start streaming applications to users.
|
CreateStreamingURLResult |
createStreamingURL(CreateStreamingURLRequest request)
Creates a temporary URL to start an AppStream 2.0 streaming session for the specified user.
|
CreateUpdatedImageResult |
createUpdatedImage(CreateUpdatedImageRequest request)
Creates a new image with the latest Windows operating system updates, driver updates, and AppStream 2.0 agent
software.
|
CreateUsageReportSubscriptionResult |
createUsageReportSubscription(CreateUsageReportSubscriptionRequest request)
Creates a usage report subscription.
|
CreateUserResult |
createUser(CreateUserRequest request)
Creates a new user in the user pool.
|
DeleteDirectoryConfigResult |
deleteDirectoryConfig(DeleteDirectoryConfigRequest request)
Deletes the specified Directory Config object from AppStream 2.0.
|
DeleteFleetResult |
deleteFleet(DeleteFleetRequest request)
Deletes the specified fleet.
|
DeleteImageResult |
deleteImage(DeleteImageRequest request)
Deletes the specified image.
|
DeleteImageBuilderResult |
deleteImageBuilder(DeleteImageBuilderRequest request)
Deletes the specified image builder and releases the capacity.
|
DeleteImagePermissionsResult |
deleteImagePermissions(DeleteImagePermissionsRequest request)
Deletes permissions for the specified private image.
|
DeleteStackResult |
deleteStack(DeleteStackRequest request)
Deletes the specified stack.
|
DeleteUsageReportSubscriptionResult |
deleteUsageReportSubscription(DeleteUsageReportSubscriptionRequest request)
Disables usage report generation.
|
DeleteUserResult |
deleteUser(DeleteUserRequest request)
Deletes a user from the user pool.
|
DescribeDirectoryConfigsResult |
describeDirectoryConfigs(DescribeDirectoryConfigsRequest request)
Retrieves a list that describes one or more specified Directory Config objects for AppStream 2.0, if the names
for these objects are provided.
|
DescribeFleetsResult |
describeFleets(DescribeFleetsRequest request)
Retrieves a list that describes one or more specified fleets, if the fleet names are provided.
|
DescribeImageBuildersResult |
describeImageBuilders(DescribeImageBuildersRequest request)
Retrieves a list that describes one or more specified image builders, if the image builder names are provided.
|
DescribeImagePermissionsResult |
describeImagePermissions(DescribeImagePermissionsRequest request)
Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own.
|
DescribeImagesResult |
describeImages(DescribeImagesRequest request)
Retrieves a list that describes one or more specified images, if the image names or image ARNs are provided.
|
DescribeSessionsResult |
describeSessions(DescribeSessionsRequest request)
Retrieves a list that describes the streaming sessions for a specified stack and fleet.
|
DescribeStacksResult |
describeStacks(DescribeStacksRequest request)
Retrieves a list that describes one or more specified stacks, if the stack names are provided.
|
DescribeUsageReportSubscriptionsResult |
describeUsageReportSubscriptions(DescribeUsageReportSubscriptionsRequest request)
Retrieves a list that describes one or more usage report subscriptions.
|
DescribeUsersResult |
describeUsers(DescribeUsersRequest request)
Retrieves a list that describes one or more specified users in the user pool.
|
DescribeUserStackAssociationsResult |
describeUserStackAssociations(DescribeUserStackAssociationsRequest request)
Retrieves a list that describes the UserStackAssociation objects.
|
DisableUserResult |
disableUser(DisableUserRequest request)
Disables the specified user in the user pool.
|
DisassociateFleetResult |
disassociateFleet(DisassociateFleetRequest request)
Disassociates the specified fleet from the specified stack.
|
EnableUserResult |
enableUser(EnableUserRequest request)
Enables a user in the user pool.
|
ExpireSessionResult |
expireSession(ExpireSessionRequest request)
Immediately stops the specified streaming session.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues
where a service isn't acting as expected.
|
ListAssociatedFleetsResult |
listAssociatedFleets(ListAssociatedFleetsRequest request)
Retrieves the name of the fleet that is associated with the specified stack.
|
ListAssociatedStacksResult |
listAssociatedStacks(ListAssociatedStacksRequest request)
Retrieves the name of the stack with which the specified fleet is associated.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Retrieves a list of all tags for the specified AppStream 2.0 resource.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
StartFleetResult |
startFleet(StartFleetRequest request)
Starts the specified fleet.
|
StartImageBuilderResult |
startImageBuilder(StartImageBuilderRequest request)
Starts the specified image builder.
|
StopFleetResult |
stopFleet(StopFleetRequest request)
Stops the specified fleet.
|
StopImageBuilderResult |
stopImageBuilder(StopImageBuilderRequest request)
Stops the specified image builder.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Adds or overwrites one or more tags for the specified AppStream 2.0 resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Disassociates one or more specified tags from the specified AppStream 2.0 resource.
|
UpdateDirectoryConfigResult |
updateDirectoryConfig(UpdateDirectoryConfigRequest request)
Updates the specified Directory Config object in AppStream 2.0.
|
UpdateFleetResult |
updateFleet(UpdateFleetRequest request)
Updates the specified fleet.
|
UpdateImagePermissionsResult |
updateImagePermissions(UpdateImagePermissionsRequest request)
Adds or updates permissions for the specified private image.
|
UpdateStackResult |
updateStack(UpdateStackRequest request)
Updates the specified fields for the specified stack.
|
AmazonAppStreamWaiters |
waiters() |
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitsetEndpoint, setRegion@Deprecated public AmazonAppStreamClient()
AmazonAppStreamClientBuilder.defaultClient()All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain@Deprecated public AmazonAppStreamClient(ClientConfiguration clientConfiguration)
AwsClientBuilder.withClientConfiguration(ClientConfiguration)All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration - The client configuration options controlling how this client connects to Amazon AppStream (ex: proxy
settings, retry counts, etc.).DefaultAWSCredentialsProviderChain@Deprecated public AmazonAppStreamClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example:
AmazonAppStreamClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.@Deprecated public AmazonAppStreamClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration - The client configuration options controlling how this client connects to Amazon AppStream (ex: proxy
settings, retry counts, etc.).@Deprecated public AmazonAppStreamClient(AWSCredentialsProvider awsCredentialsProvider)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.@Deprecated public AmazonAppStreamClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration - The client configuration options controlling how this client connects to Amazon AppStream (ex: proxy
settings, retry counts, etc.).@Deprecated public AmazonAppStreamClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
AwsClientBuilder.withCredentials(AWSCredentialsProvider) and
AwsClientBuilder.withClientConfiguration(ClientConfiguration) and
AwsClientBuilder.withMetricsCollector(RequestMetricCollector)All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration - The client configuration options controlling how this client connects to Amazon AppStream (ex: proxy
settings, retry counts, etc.).requestMetricCollector - optional request metric collectorpublic static AmazonAppStreamClientBuilder builder()
public AssociateFleetResult associateFleet(AssociateFleetRequest request)
Associates the specified fleet with the specified stack.
associateFleet in interface AmazonAppStreamassociateFleetRequest - LimitExceededException - The requested limit exceeds the permitted limit for an account.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.IncompatibleImageException - The image can't be updated because it's not compatible for updates.OperationNotPermittedException - The attempted operation is not permitted.public BatchAssociateUserStackResult batchAssociateUserStack(BatchAssociateUserStackRequest request)
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.
batchAssociateUserStack in interface AmazonAppStreambatchAssociateUserStackRequest - OperationNotPermittedException - The attempted operation is not permitted.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.public BatchDisassociateUserStackResult batchDisassociateUserStack(BatchDisassociateUserStackRequest request)
Disassociates the specified users from the specified stacks.
batchDisassociateUserStack in interface AmazonAppStreambatchDisassociateUserStackRequest - OperationNotPermittedException - The attempted operation is not permitted.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.public CopyImageResult copyImage(CopyImageRequest request)
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.
copyImage in interface AmazonAppStreamcopyImageRequest - ResourceAlreadyExistsException - The specified resource already exists.ResourceNotFoundException - The specified resource was not found.ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.LimitExceededException - The requested limit exceeds the permitted limit for an account.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.IncompatibleImageException - The image can't be updated because it's not compatible for updates.public CreateDirectoryConfigResult createDirectoryConfig(CreateDirectoryConfigRequest request)
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.
createDirectoryConfig in interface AmazonAppStreamcreateDirectoryConfigRequest - ResourceNotFoundException - The specified resource was not found.ResourceAlreadyExistsException - The specified resource already exists.LimitExceededException - The requested limit exceeds the permitted limit for an account.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.OperationNotPermittedException - The attempted operation is not permitted.InvalidRoleException - The specified role is invalid.public CreateFleetResult createFleet(CreateFleetRequest request)
Creates a fleet. A fleet consists of streaming instances that run a specified image.
createFleet in interface AmazonAppStreamcreateFleetRequest - ResourceAlreadyExistsException - The specified resource already exists.ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.ResourceNotFoundException - The specified resource was not found.LimitExceededException - The requested limit exceeds the permitted limit for an account.RequestLimitExceededException - AppStream 2.0 can’t process the request right now because the Describe calls from your AWS account are
being throttled by Amazon EC2. Try again later.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.InvalidRoleException - The specified role is invalid.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.IncompatibleImageException - The image can't be updated because it's not compatible for updates.OperationNotPermittedException - The attempted operation is not permitted.public CreateImageBuilderResult createImageBuilder(CreateImageBuilderRequest request)
Creates an image builder. An image builder is a virtual machine that is used to create an image.
The initial state of the builder is PENDING. When it is ready, the state is RUNNING.
createImageBuilder in interface AmazonAppStreamcreateImageBuilderRequest - LimitExceededException - The requested limit exceeds the permitted limit for an account.RequestLimitExceededException - AppStream 2.0 can’t process the request right now because the Describe calls from your AWS account are
being throttled by Amazon EC2. Try again later.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.ResourceAlreadyExistsException - The specified resource already exists.ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.ResourceNotFoundException - The specified resource was not found.InvalidRoleException - The specified role is invalid.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.IncompatibleImageException - The image can't be updated because it's not compatible for updates.OperationNotPermittedException - The attempted operation is not permitted.public CreateImageBuilderStreamingURLResult createImageBuilderStreamingURL(CreateImageBuilderStreamingURLRequest request)
Creates a URL to start an image builder streaming session.
createImageBuilderStreamingURL in interface AmazonAppStreamcreateImageBuilderStreamingURLRequest - OperationNotPermittedException - The attempted operation is not permitted.ResourceNotFoundException - The specified resource was not found.public CreateStackResult createStack(CreateStackRequest request)
Creates a stack to start streaming applications to users. A stack consists of an associated fleet, user access policies, and storage configurations.
createStack in interface AmazonAppStreamcreateStackRequest - LimitExceededException - The requested limit exceeds the permitted limit for an account.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.ResourceAlreadyExistsException - The specified resource already exists.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.InvalidRoleException - The specified role is invalid.ResourceNotFoundException - The specified resource was not found.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.public CreateStreamingURLResult createStreamingURL(CreateStreamingURLRequest request)
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.
createStreamingURL in interface AmazonAppStreamcreateStreamingURLRequest - ResourceNotFoundException - The specified resource was not found.ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.OperationNotPermittedException - The attempted operation is not permitted.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.public CreateUpdatedImageResult createUpdatedImage(CreateUpdatedImageRequest request)
Creates a new image with the latest Windows operating system updates, driver updates, and AppStream 2.0 agent software.
For more information, see the "Update an Image by Using Managed AppStream 2.0 Image Updates" section in Administer Your AppStream 2.0 Images, in the Amazon AppStream 2.0 Administration Guide.
createUpdatedImage in interface AmazonAppStreamcreateUpdatedImageRequest - LimitExceededException - The requested limit exceeds the permitted limit for an account.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.OperationNotPermittedException - The attempted operation is not permitted.ResourceAlreadyExistsException - The specified resource already exists.ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.IncompatibleImageException - The image can't be updated because it's not compatible for updates.public CreateUsageReportSubscriptionResult createUsageReportSubscription(CreateUsageReportSubscriptionRequest request)
Creates a usage report subscription. Usage reports are generated daily.
createUsageReportSubscription in interface AmazonAppStreamcreateUsageReportSubscriptionRequest - InvalidRoleException - The specified role is invalid.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.LimitExceededException - The requested limit exceeds the permitted limit for an account.public CreateUserResult createUser(CreateUserRequest request)
Creates a new user in the user pool.
createUser in interface AmazonAppStreamcreateUserRequest - ResourceAlreadyExistsException - The specified resource already exists.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.LimitExceededException - The requested limit exceeds the permitted limit for an account.OperationNotPermittedException - The attempted operation is not permitted.public DeleteDirectoryConfigResult deleteDirectoryConfig(DeleteDirectoryConfigRequest request)
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.
deleteDirectoryConfig in interface AmazonAppStreamdeleteDirectoryConfigRequest - ResourceInUseException - The specified resource is in use.ResourceNotFoundException - The specified resource was not found.public DeleteFleetResult deleteFleet(DeleteFleetRequest request)
Deletes the specified fleet.
deleteFleet in interface AmazonAppStreamdeleteFleetRequest - ResourceInUseException - The specified resource is in use.ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.public DeleteImageResult deleteImage(DeleteImageRequest request)
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.
deleteImage in interface AmazonAppStreamdeleteImageRequest - ResourceInUseException - The specified resource is in use.ResourceNotFoundException - The specified resource was not found.OperationNotPermittedException - The attempted operation is not permitted.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.public DeleteImageBuilderResult deleteImageBuilder(DeleteImageBuilderRequest request)
Deletes the specified image builder and releases the capacity.
deleteImageBuilder in interface AmazonAppStreamdeleteImageBuilderRequest - ResourceNotFoundException - The specified resource was not found.OperationNotPermittedException - The attempted operation is not permitted.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.public DeleteImagePermissionsResult deleteImagePermissions(DeleteImagePermissionsRequest request)
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.
deleteImagePermissions in interface AmazonAppStreamdeleteImagePermissionsRequest - ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.ResourceNotFoundException - The specified resource was not found.public DeleteStackResult deleteStack(DeleteStackRequest request)
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.
deleteStack in interface AmazonAppStreamdeleteStackRequest - ResourceInUseException - The specified resource is in use.ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.public DeleteUsageReportSubscriptionResult deleteUsageReportSubscription(DeleteUsageReportSubscriptionRequest request)
Disables usage report generation.
deleteUsageReportSubscription in interface AmazonAppStreamdeleteUsageReportSubscriptionRequest - InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.ResourceNotFoundException - The specified resource was not found.public DeleteUserResult deleteUser(DeleteUserRequest request)
Deletes a user from the user pool.
deleteUser in interface AmazonAppStreamdeleteUserRequest - ResourceNotFoundException - The specified resource was not found.public DescribeDirectoryConfigsResult describeDirectoryConfigs(DescribeDirectoryConfigsRequest request)
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.
Although the response syntax in this topic includes the account password, this password is not returned in the actual response.
describeDirectoryConfigs in interface AmazonAppStreamdescribeDirectoryConfigsRequest - ResourceNotFoundException - The specified resource was not found.public DescribeFleetsResult describeFleets(DescribeFleetsRequest request)
Retrieves a list that describes one or more specified fleets, if the fleet names are provided. Otherwise, all fleets in the account are described.
describeFleets in interface AmazonAppStreamdescribeFleetsRequest - ResourceNotFoundException - The specified resource was not found.public DescribeImageBuildersResult describeImageBuilders(DescribeImageBuildersRequest request)
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.
describeImageBuilders in interface AmazonAppStreamdescribeImageBuildersRequest - ResourceNotFoundException - The specified resource was not found.public DescribeImagePermissionsResult describeImagePermissions(DescribeImagePermissionsRequest request)
Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own.
describeImagePermissions in interface AmazonAppStreamdescribeImagePermissionsRequest - ResourceNotFoundException - The specified resource was not found.public DescribeImagesResult describeImages(DescribeImagesRequest request)
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.
describeImages in interface AmazonAppStreamdescribeImagesRequest - InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.ResourceNotFoundException - The specified resource was not found.public DescribeSessionsResult describeSessions(DescribeSessionsRequest request)
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.
describeSessions in interface AmazonAppStreamdescribeSessionsRequest - InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.public DescribeStacksResult describeStacks(DescribeStacksRequest request)
Retrieves a list that describes one or more specified stacks, if the stack names are provided. Otherwise, all stacks in the account are described.
describeStacks in interface AmazonAppStreamdescribeStacksRequest - ResourceNotFoundException - The specified resource was not found.public DescribeUsageReportSubscriptionsResult describeUsageReportSubscriptions(DescribeUsageReportSubscriptionsRequest request)
Retrieves a list that describes one or more usage report subscriptions.
describeUsageReportSubscriptions in interface AmazonAppStreamdescribeUsageReportSubscriptionsRequest - ResourceNotFoundException - The specified resource was not found.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.public DescribeUserStackAssociationsResult describeUserStackAssociations(DescribeUserStackAssociationsRequest request)
Retrieves a list that describes the UserStackAssociation objects. You must specify either or both of the following:
The stack name
The user name (email address of the user associated with the stack) and the authentication type for the user
describeUserStackAssociations in interface AmazonAppStreamdescribeUserStackAssociationsRequest - InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.OperationNotPermittedException - The attempted operation is not permitted.public DescribeUsersResult describeUsers(DescribeUsersRequest request)
Retrieves a list that describes one or more specified users in the user pool.
describeUsers in interface AmazonAppStreamdescribeUsersRequest - ResourceNotFoundException - The specified resource was not found.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.public DisableUserResult disableUser(DisableUserRequest request)
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.
disableUser in interface AmazonAppStreamdisableUserRequest - ResourceNotFoundException - The specified resource was not found.public DisassociateFleetResult disassociateFleet(DisassociateFleetRequest request)
Disassociates the specified fleet from the specified stack.
disassociateFleet in interface AmazonAppStreamdisassociateFleetRequest - ResourceInUseException - The specified resource is in use.ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.OperationNotPermittedException - The attempted operation is not permitted.public EnableUserResult enableUser(EnableUserRequest request)
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.
enableUser in interface AmazonAppStreamenableUserRequest - ResourceNotFoundException - The specified resource was not found.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.public ExpireSessionResult expireSession(ExpireSessionRequest request)
Immediately stops the specified streaming session.
expireSession in interface AmazonAppStreamexpireSessionRequest - public ListAssociatedFleetsResult listAssociatedFleets(ListAssociatedFleetsRequest request)
Retrieves the name of the fleet that is associated with the specified stack.
listAssociatedFleets in interface AmazonAppStreamlistAssociatedFleetsRequest - public ListAssociatedStacksResult listAssociatedStacks(ListAssociatedStacksRequest request)
Retrieves the name of the stack with which the specified fleet is associated.
listAssociatedStacks in interface AmazonAppStreamlistAssociatedStacksRequest - public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
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.
For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Administration Guide.
listTagsForResource in interface AmazonAppStreamlistTagsForResourceRequest - ResourceNotFoundException - The specified resource was not found.public StartFleetResult startFleet(StartFleetRequest request)
Starts the specified fleet.
startFleet in interface AmazonAppStreamstartFleetRequest - ResourceNotFoundException - The specified resource was not found.OperationNotPermittedException - The attempted operation is not permitted.LimitExceededException - The requested limit exceeds the permitted limit for an account.RequestLimitExceededException - AppStream 2.0 can’t process the request right now because the Describe calls from your AWS account are
being throttled by Amazon EC2. Try again later.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.InvalidRoleException - The specified role is invalid.public StartImageBuilderResult startImageBuilder(StartImageBuilderRequest request)
Starts the specified image builder.
startImageBuilder in interface AmazonAppStreamstartImageBuilderRequest - ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.IncompatibleImageException - The image can't be updated because it's not compatible for updates.public StopFleetResult stopFleet(StopFleetRequest request)
Stops the specified fleet.
stopFleet in interface AmazonAppStreamstopFleetRequest - ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.public StopImageBuilderResult stopImageBuilder(StopImageBuilderRequest request)
Stops the specified image builder.
stopImageBuilder in interface AmazonAppStreamstopImageBuilderRequest - ResourceNotFoundException - The specified resource was not found.OperationNotPermittedException - The attempted operation is not permitted.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.public TagResourceResult tagResource(TagResourceRequest request)
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.
Each tag consists of a key and an optional value. If a resource already has a tag with the same key, this operation updates its value.
To list the current tags for your resources, use ListTagsForResource. To disassociate tags from your resources, use UntagResource.
For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Administration Guide.
tagResource in interface AmazonAppStreamtagResourceRequest - LimitExceededException - The requested limit exceeds the permitted limit for an account.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.ResourceNotFoundException - The specified resource was not found.public UntagResourceResult untagResource(UntagResourceRequest request)
Disassociates one or more specified tags from the specified AppStream 2.0 resource.
To list the current tags for your resources, use ListTagsForResource.
For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Administration Guide.
untagResource in interface AmazonAppStreamuntagResourceRequest - ResourceNotFoundException - The specified resource was not found.public UpdateDirectoryConfigResult updateDirectoryConfig(UpdateDirectoryConfigRequest request)
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.
updateDirectoryConfig in interface AmazonAppStreamupdateDirectoryConfigRequest - ResourceInUseException - The specified resource is in use.ResourceNotFoundException - The specified resource was not found.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.OperationNotPermittedException - The attempted operation is not permitted.InvalidRoleException - The specified role is invalid.public UpdateFleetResult updateFleet(UpdateFleetRequest request)
Updates the specified fleet.
If the fleet is in the STOPPED state, you can update any attribute except the fleet name. If the
fleet is in the RUNNING state, you can update the DisplayName,
ComputeCapacity, ImageARN, ImageName,
IdleDisconnectTimeoutInSeconds, and DisconnectTimeoutInSeconds attributes. If the fleet
is in the STARTING or STOPPING state, you can't update it.
updateFleet in interface AmazonAppStreamupdateFleetRequest - ResourceInUseException - The specified resource is in use.LimitExceededException - The requested limit exceeds the permitted limit for an account.RequestLimitExceededException - AppStream 2.0 can’t process the request right now because the Describe calls from your AWS account are
being throttled by Amazon EC2. Try again later.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.InvalidRoleException - The specified role is invalid.ResourceNotFoundException - The specified resource was not found.ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.IncompatibleImageException - The image can't be updated because it's not compatible for updates.OperationNotPermittedException - The attempted operation is not permitted.public UpdateImagePermissionsResult updateImagePermissions(UpdateImagePermissionsRequest request)
Adds or updates permissions for the specified private image.
updateImagePermissions in interface AmazonAppStreamupdateImagePermissionsRequest - ResourceNotFoundException - The specified resource was not found.ResourceNotAvailableException - The specified resource exists and is not in use, but isn't available.LimitExceededException - The requested limit exceeds the permitted limit for an account.public UpdateStackResult updateStack(UpdateStackRequest request)
Updates the specified fields for the specified stack.
updateStack in interface AmazonAppStreamupdateStackRequest - ResourceNotFoundException - The specified resource was not found.ResourceInUseException - The specified resource is in use.InvalidRoleException - The specified role is invalid.InvalidParameterCombinationException - Indicates an incorrect combination of parameters, or a missing parameter.LimitExceededException - The requested limit exceeds the permitted limit for an account.InvalidAccountStatusException - The resource cannot be created because your AWS account is suspended. For assistance, contact AWS
Support.IncompatibleImageException - The image can't be updated because it's not compatible for updates.OperationNotPermittedException - The attempted operation is not permitted.ConcurrentModificationException - An API error occurred. Wait a few minutes and try again.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata in interface AmazonAppStreamrequest - The originally executed requestpublic AmazonAppStreamWaiters waiters()
waiters in interface AmazonAppStreampublic void shutdown()
AmazonWebServiceClientshutdown in interface AmazonAppStreamshutdown in class AmazonWebServiceClient