Network.AWS.GameLift.CreateBuild

Initializes a new build record and generates information required to upload a game build to Amazon GameLift. Once the build record has been created and is in an INITIALIZED state, you can upload your game build.

To create a build, use the CLI command 'upload-build', which creates a new build record and uploads the build files in one step. (See the Amazon GameLift Developer Guide for more details on the CLI and the upload process.) Call the CreateBuild action only if you have your own Amazon Simple Storage Service (Amazon S3) client and need to manually upload your build files.

To create a new build, optionally specify a build name and version. This metadata is stored with other properties in the build record and is displayed in the GameLift console (but not visible to players). If successful, this action returns the newly created build record along with an Amazon S3 storage location and AWS account credentials. Use the location and credentials to upload your game build.

Creating a Request

createBuild :: CreateBuild

Creates a value of CreateBuild with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cbStorageLocation
• cbName
• cbVersion

data CreateBuild

Represents the input for a request action.

See: createBuild smart constructor.

Instances

Eq CreateBuild

Data CreateBuild

Read CreateBuild

Show CreateBuild

Generic CreateBuild

ToJSON CreateBuild

Hashable CreateBuild

AWSRequest CreateBuild

ToPath CreateBuild

ToHeaders CreateBuild

ToQuery CreateBuild

type Rep CreateBuild

type Rs CreateBuild = CreateBuildResponse

Request Lenses

cbStorageLocation :: Lens' CreateBuild (Maybe S3Location)

Undocumented member.

cbName :: Lens' CreateBuild (Maybe Text)

Descriptive label associated with this build. Build names do not need to be unique. A build name can be changed later using UpdateBuild.

cbVersion :: Lens' CreateBuild (Maybe Text)

Version associated with this build. Version strings do not need to be unique to a build. A build version can be changed later using UpdateBuild.

Destructuring the Response

createBuildResponse

Arguments

:: Int

cbrsResponseStatus

-> CreateBuildResponse

Creates a value of CreateBuildResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cbrsStorageLocation
• cbrsUploadCredentials
• cbrsBuild
• cbrsResponseStatus

data CreateBuildResponse

Represents the returned data in response to a request action.

See: createBuildResponse smart constructor.

Instances

Eq CreateBuildResponse

Data CreateBuildResponse

Read CreateBuildResponse

Show CreateBuildResponse

Generic CreateBuildResponse

type Rep CreateBuildResponse

Response Lenses

cbrsStorageLocation :: Lens' CreateBuildResponse (Maybe S3Location)

Amazon S3 path and key, identifying where the game build files are stored.

cbrsUploadCredentials :: Lens' CreateBuildResponse (Maybe AWSCredentials)

AWS credentials required when uploading a game build to the storage location. These credentials have a limited lifespan and are valid only for the build they were issued for. If you need to get fresh credentials, call RequestUploadCredentials.

cbrsBuild :: Lens' CreateBuildResponse (Maybe Build)

Set of properties for the newly created build.

cbrsResponseStatus :: Lens' CreateBuildResponse Int

The response status code.