AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
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
.zip 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.
CreateBuild 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
INITIALIZED status. You can use DescribeBuild to
check the status of your build. A build must be in
READY status before
it can be used to create fleets.
Build-related operations include:
For .NET Core and PCL this operation is only available in asynchronous form. Please refer to CreateBuildAsync.
public abstract CreateBuildResponse CreateBuild( CreateBuildRequest request )
Container for the necessary parameters to execute the CreateBuild service method.
|ConflictException||The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.|
|InternalServiceException||The service encountered an unrecoverable internal failure while processing the request. Clients can retry such requests immediately or after a waiting period.|
|InvalidRequestException||One or more parameter values in the request are invalid. Correct the invalid parameter values before retrying.|
|UnauthorizedException||The client failed authentication. Clients should not retry such requests.|
Supported in: 4.5, 4.0, 3.5
Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms