Documentation

Properties describing a custom game build.

Related actions

CreateBuild | ListBuilds | DescribeBuild | UpdateBuild | DeleteBuild | All APIs by task

See: newBuild smart constructor.

Create a value of Build with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:creationTime:Build', build_creationTime - A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").

$sel:status:Build', build_status - Current status of the build.

Possible build statuses include the following:

• INITIALIZED -- A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value.
• READY -- The game build has been successfully uploaded. You can now create new fleets for this build.
• FAILED -- The game build upload failed. You cannot create new fleets for this build.

$sel:operatingSystem:Build', build_operatingSystem - Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build.

$sel:buildId:Build', build_buildId - A unique identifier for the build.

$sel:name:Build', build_name - A descriptive label that is associated with a build. Build names do not need to be unique. It can be set using CreateBuild or UpdateBuild.

$sel:version:Build', build_version - Version information that is associated with a build or script. Version strings do not need to be unique. This value can be set using CreateBuild or UpdateBuild.

$sel:buildArn:Build', build_buildArn - The Amazon Resource Name (ARN) that is assigned to a GameLift build resource and uniquely identifies it. ARNs are unique across all Regions. Format is arn:aws:gamelift:<region>::build/build-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. In a GameLift build ARN, the resource ID matches the BuildId value.

$sel:sizeOnDisk:Build', build_sizeOnDisk - File size of the uploaded game build, expressed in bytes. When the build status is INITIALIZED, this value is 0.

A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").

Current status of the build.

Possible build statuses include the following:

• INITIALIZED -- A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value.
• READY -- The game build has been successfully uploaded. You can now create new fleets for this build.
• FAILED -- The game build upload failed. You cannot create new fleets for this build.

Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build.

A unique identifier for the build.

A descriptive label that is associated with a build. Build names do not need to be unique. It can be set using CreateBuild or UpdateBuild.

Version information that is associated with a build or script. Version strings do not need to be unique. This value can be set using CreateBuild or UpdateBuild.

The Amazon Resource Name (ARN) that is assigned to a GameLift build resource and uniquely identifies it. ARNs are unique across all Regions. Format is arn:aws:gamelift:<region>::build/build-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. In a GameLift build ARN, the resource ID matches the BuildId value.

File size of the uploaded game build, expressed in bytes. When the build status is INITIALIZED, this value is 0.