Creates a new Amazon GameLift build record for your game server binary files and points to the location of your game server build files in an Amazon Simple Storage Service (Amazon S3) location.
Game server binaries must be combined into a
file for use with Amazon GameLift. See Uploading Your Game
for more information. To create new builds quickly and easily, use the AWS CLI command upload-build. This helper command uploads your build and creates a new build record in one step, and automatically handles the necessary permissions. See Upload Build Files to Amazon GameLift for more help.
operation should be used only when you need to manually upload your build files, as in the following scenarios:
- Store a build file in an Amazon S3 bucket under your own AWS account. To use this option, you must first give Amazon GameLift access to that Amazon S3 bucket. See Create a Build with Files in Amazon S3 for detailed help. To create a new build record using files in your Amazon S3 bucket, call
CreateBuild and specify a build name, operating system, and the storage location of your game build.
- Upload a build file directly to Amazon GameLift's Amazon S3 account. To use this option, you first call
CreateBuild with a build name and operating system. This action creates a new build record and returns an Amazon S3 storage location (bucket and key only) and temporary access credentials. Use the credentials to manually upload your build file to the storage location (see the Amazon S3 topic Uploading Objects). You can upload files to a location only once.
If successful, this operation creates a new build record with a unique build ID and places it in
status. You can use DescribeBuild
to check the status of your build. A build must be in
status before it can be used to create fleets.
Build-related operations include: