AWS Fundamentals Logo
AWS Fundamentals
L1 Construct

CfnApplication

The `AWS::GameLiftStreams::Application` resource defines an Amazon GameLift Streams application. An application specifies the content that you want to stream, such as a game or other software, and its runtime environment (Microsoft Windows, Ubuntu, or Proton). Before you create an Amazon GameLift Streams application, upload your *uncompressed* game files (do not upload a .zip file) to an Amazon Simple Storage Service (Amazon S3) standard bucket.

Import

import { CfnApplication } from 'aws-cdk-lib/aws-gameliftstreams';

Or use the module namespace:

import * as gameliftstreams from 'aws-cdk-lib/aws-gameliftstreams';
// gameliftstreams.CfnApplication

Properties

Configuration passed to the constructor as CfnApplicationProps.

applicationSourceUriRequired
string

The location of the content that you want to stream. Enter an Amazon S3 URI to a bucket that contains your game or other application. The location can have a multi-level prefix structure, but it must include all the files needed to run the content. Amazon GameLift Streams copies everything under the specified location. This value is immutable. To designate a different content location, create a new application. > The Amazon S3 bucket and the Amazon GameLift Streams application must be in the same AWS Region.

descriptionRequired
string

A human-readable label for the application. You can update this value later.

executablePathRequired
string

The relative path and file name of the executable file that Amazon GameLift Streams will stream. Specify a path relative to the location set in `ApplicationSourceUri` . The file must be contained within the application's root folder. For Windows applications, the file must be a valid Windows executable or batch file with a filename ending in .exe, .cmd, or .bat. For Linux applications, the file must be a valid Linux binary executable or a script that contains an initial interpreter line starting with a shebang (' `#!` ').

runtimeEnvironmentRequired
IResolvable | RuntimeEnvironmentProperty

A set of configuration settings to run the application on a stream group. This configures the operating system, and can include compatibility layers and other drivers.

applicationLogOutputUriOptional
string

An Amazon S3 URI to a bucket where you would like Amazon GameLift Streams to save application logs. Required if you specify one or more `ApplicationLogPaths` .

applicationLogPathsOptional
string[]

Locations of log files that your content generates during a stream session. Enter path values that are relative to the `ApplicationSourceUri` location. You can specify up to 10 log paths. Amazon GameLift Streams uploads designated log files to the Amazon S3 bucket that you specify in `ApplicationLogOutputUri` at the end of a stream session. To retrieve stored log files, call [GetStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamSession.html) and get the `LogFileLocationUri` .

tagsOptional
{ [key: string]: string }

A list of labels to assign to the new application resource. Tags are developer-defined key-value pairs. Tagging AWS resources is useful for resource management, access management and cost allocation. See [Tagging AWS Resources](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) in the *AWS General Reference* .

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL1 (CloudFormation)
Moduleaws-gameliftstreams
Properties7

Related Constructs

External Links