Amazon AppStream
Developer Guide

This documentation is for an older version of Amazon AppStream. For information about the latest version, see the Amazon AppStream 2.0 Developer Guide.


You can use a POST request on the href of this link to update the metadata fields associated with an application hosted on Amazon AppStream. Updating the state affects the active applications. Updating the state does not affect the active sessions.


In order to update the state of an application, you must pass in the following field during your POST request.

Input Field Description
name The new name of the application.
description The new description of the application. This is used internally by Amazon AppStream and not displayed to end users.
launchCommand The new command to launch the application. This command is run on the streaming server after it finishes allocating. The command starts the application on the server.
logBucket The name of the Amazon S3 bucket where the .zip files contains the logs are uploaded. The bucket must already exist and allow Amazon AppStream to use the PutObject method.
logPaths A string array whose elements contain the log filenames or directory path where logs are stored. The filenames and paths must meet the following requirements:
  • Log files must be located in the C:\ directory.

  • Log paths must be fully qualified paths. Do not use relative paths. You can use wildcards.

  • Log paths must be less than the path length limits. See Naming Files, Paths, and Namespaces.

  • Log file names cannot contain Windows reserved characters. See Naming Conventions.

  • Your application must have read access to the paths.


The total size of logs in the .zip file is subject to the Amazon S3 key size limits.


The updated Application.

On this page: