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

application:create

You can use a POST request on the href of this link to add an application to Amazon AppStream. You must have previously uploaded your application's installation package to Amazon S3 and generated a presigned URL for the package's location in Amazon S3. For more information about generating presigned URLs, see Share an Object with Others in the Amazon Simple Storage Service Developer Guide.

Input

In order to add an application to Amazon AppStream, you must pass in the following fields during your POST request.

Input Field Description
name The name of the application.
description (Optional) The description of the application. This description is used to describe the application in Amazon AppStream, it is not displayed to end users.
installerUrl A presigned URL that points to the location in Amazon S3 that contains the installation package for the application. For more information on creating a presigned URL, see Share an Object with Others in the Amazon Simple Storage Service Developer Guide.
installerParameters The command to run to install the application on an Amazon AppStream host managed by Amazon AppStream. This should include all necessary command-line parameters.
launchCommand The command to run in order to launch the application after it is hosted on Amazon AppStream. This should include all necessary command-line parameters.
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.

Note

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

Output

The newly created Application.

Example Request

Copy
POST /applications HTTP/1.1 Host: appstream.us-east-1.amazonaws.com Accept: application/hal+json Version=4 X-Amz-Algorithm=AWS4-HMAC-SHA256 X-Amz-Credential=...%2Fus-east-1%2Fappstream%2Faws4_request X-Amz-Date=2013-11-06T19%3A18%3A42.323Z X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date X-Amz-Signature=... { "name": "SampleApp", "description": "A sample application hosted on Amazon AppStream.", "installParameters": " ", "installerUrl": "S3_URL", "launchCommand": "c:\\app\\SampleApp\\sampleapp.exe" "logBucket": "MyS3Bucket", "logPaths": [""C:\MyLog1.log","C:\MyLog2.log",C:\myapp\logs\*logs] }

Example Response

Copy
HTTP/1.1 200 OK Content-Type: application/hal+json { }

On this page: