We recommend new projects start with resources from the AWS provider.
aws-native.gamelift.Build
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
Resource Type definition for AWS::GameLift::Build
Create Build Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Build(name: string, args?: BuildArgs, opts?: CustomResourceOptions);
@overload
def Build(resource_name: str,
args: Optional[BuildArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def Build(resource_name: str,
opts: Optional[ResourceOptions] = None,
name: Optional[str] = None,
operating_system: Optional[BuildOperatingSystem] = None,
server_sdk_version: Optional[str] = None,
storage_location: Optional[BuildStorageLocationArgs] = None,
version: Optional[str] = None)
func NewBuild(ctx *Context, name string, args *BuildArgs, opts ...ResourceOption) (*Build, error)
public Build(string name, BuildArgs? args = null, CustomResourceOptions? opts = null)
type: aws-native:gamelift:Build
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args BuildArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args BuildArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args BuildArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BuildArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args BuildArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Build Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Build resource accepts the following input properties:
- Name string
- A descriptive label that is associated with a build. Build names do not need to be unique.
- Operating
System Pulumi.Aws Native. Game Lift. Build Operating System - The 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. If your game build contains multiple executables, they all must run on the same operating system. If an operating system is not specified when creating a build, Amazon GameLift uses the default value (WINDOWS_2012). This value cannot be changed later.
- Server
Sdk stringVersion - A server SDK version you used when integrating your game server build with Amazon GameLift. By default Amazon GameLift sets this value to 4.0.2.
- Storage
Location Pulumi.Aws Native. Game Lift. Inputs. Build Storage Location - Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region.
- Version string
- Version information that is associated with this build. Version strings do not need to be unique.
- Name string
- A descriptive label that is associated with a build. Build names do not need to be unique.
- Operating
System BuildOperating System - The 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. If your game build contains multiple executables, they all must run on the same operating system. If an operating system is not specified when creating a build, Amazon GameLift uses the default value (WINDOWS_2012). This value cannot be changed later.
- Server
Sdk stringVersion - A server SDK version you used when integrating your game server build with Amazon GameLift. By default Amazon GameLift sets this value to 4.0.2.
- Storage
Location BuildStorage Location Args - Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region.
- Version string
- Version information that is associated with this build. Version strings do not need to be unique.
- name String
- A descriptive label that is associated with a build. Build names do not need to be unique.
- operating
System BuildOperating System - The 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. If your game build contains multiple executables, they all must run on the same operating system. If an operating system is not specified when creating a build, Amazon GameLift uses the default value (WINDOWS_2012). This value cannot be changed later.
- server
Sdk StringVersion - A server SDK version you used when integrating your game server build with Amazon GameLift. By default Amazon GameLift sets this value to 4.0.2.
- storage
Location BuildStorage Location - Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region.
- version String
- Version information that is associated with this build. Version strings do not need to be unique.
- name string
- A descriptive label that is associated with a build. Build names do not need to be unique.
- operating
System BuildOperating System - The 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. If your game build contains multiple executables, they all must run on the same operating system. If an operating system is not specified when creating a build, Amazon GameLift uses the default value (WINDOWS_2012). This value cannot be changed later.
- server
Sdk stringVersion - A server SDK version you used when integrating your game server build with Amazon GameLift. By default Amazon GameLift sets this value to 4.0.2.
- storage
Location BuildStorage Location - Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region.
- version string
- Version information that is associated with this build. Version strings do not need to be unique.
- name str
- A descriptive label that is associated with a build. Build names do not need to be unique.
- operating_
system BuildOperating System - The 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. If your game build contains multiple executables, they all must run on the same operating system. If an operating system is not specified when creating a build, Amazon GameLift uses the default value (WINDOWS_2012). This value cannot be changed later.
- server_
sdk_ strversion - A server SDK version you used when integrating your game server build with Amazon GameLift. By default Amazon GameLift sets this value to 4.0.2.
- storage_
location BuildStorage Location Args - Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region.
- version str
- Version information that is associated with this build. Version strings do not need to be unique.
- name String
- A descriptive label that is associated with a build. Build names do not need to be unique.
- operating
System "AMAZON_LINUX" | "AMAZON_LINUX_2" | "AMAZON_LINUX_2023" | "WINDOWS_2012" | "WINDOWS_2016" - The 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. If your game build contains multiple executables, they all must run on the same operating system. If an operating system is not specified when creating a build, Amazon GameLift uses the default value (WINDOWS_2012). This value cannot be changed later.
- server
Sdk StringVersion - A server SDK version you used when integrating your game server build with Amazon GameLift. By default Amazon GameLift sets this value to 4.0.2.
- storage
Location Property Map - Information indicating where your game build files are stored. Use this parameter only when creating a build with files stored in an Amazon S3 bucket that you own. The storage location must specify an Amazon S3 bucket name and key. The location must also specify a role ARN that you set up to allow Amazon GameLift to access your Amazon S3 bucket. The S3 bucket and your new build must be in the same Region.
- version String
- Version information that is associated with this build. Version strings do not need to be unique.
Outputs
All input properties are implicitly available as output properties. Additionally, the Build resource produces the following output properties:
- Build
Id string - A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a READY status. This fleet setting cannot be changed once the fleet is created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Build
Id string - A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a READY status. This fleet setting cannot be changed once the fleet is created.
- Id string
- The provider-assigned unique ID for this managed resource.
- build
Id String - A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a READY status. This fleet setting cannot be changed once the fleet is created.
- id String
- The provider-assigned unique ID for this managed resource.
- build
Id string - A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a READY status. This fleet setting cannot be changed once the fleet is created.
- id string
- The provider-assigned unique ID for this managed resource.
- build_
id str - A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a READY status. This fleet setting cannot be changed once the fleet is created.
- id str
- The provider-assigned unique ID for this managed resource.
- build
Id String - A unique identifier for a build to be deployed on the new fleet. If you are deploying the fleet with a custom game build, you must specify this property. The build must have been successfully uploaded to Amazon GameLift and be in a READY status. This fleet setting cannot be changed once the fleet is created.
- id String
- The provider-assigned unique ID for this managed resource.
Supporting Types
BuildOperatingSystem, BuildOperatingSystemArgs
- Amazon
Linux - AMAZON_LINUX
- Amazon
Linux2 - AMAZON_LINUX_2
- Amazon
Linux2023 - AMAZON_LINUX_2023
- Windows2012
- WINDOWS_2012
- Windows2016
- WINDOWS_2016
- Build
Operating System Amazon Linux - AMAZON_LINUX
- Build
Operating System Amazon Linux2 - AMAZON_LINUX_2
- Build
Operating System Amazon Linux2023 - AMAZON_LINUX_2023
- Build
Operating System Windows2012 - WINDOWS_2012
- Build
Operating System Windows2016 - WINDOWS_2016
- Amazon
Linux - AMAZON_LINUX
- Amazon
Linux2 - AMAZON_LINUX_2
- Amazon
Linux2023 - AMAZON_LINUX_2023
- Windows2012
- WINDOWS_2012
- Windows2016
- WINDOWS_2016
- Amazon
Linux - AMAZON_LINUX
- Amazon
Linux2 - AMAZON_LINUX_2
- Amazon
Linux2023 - AMAZON_LINUX_2023
- Windows2012
- WINDOWS_2012
- Windows2016
- WINDOWS_2016
- AMAZON_LINUX
- AMAZON_LINUX
- AMAZON_LINUX2
- AMAZON_LINUX_2
- AMAZON_LINUX2023
- AMAZON_LINUX_2023
- WINDOWS2012
- WINDOWS_2012
- WINDOWS2016
- WINDOWS_2016
- "AMAZON_LINUX"
- AMAZON_LINUX
- "AMAZON_LINUX_2"
- AMAZON_LINUX_2
- "AMAZON_LINUX_2023"
- AMAZON_LINUX_2023
- "WINDOWS_2012"
- WINDOWS_2012
- "WINDOWS_2016"
- WINDOWS_2016
BuildStorageLocation, BuildStorageLocationArgs
- Bucket string
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- Key string
- The name of the zip file that contains the build files or script files.
- Role
Arn string - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- Object
Version string - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- Bucket string
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- Key string
- The name of the zip file that contains the build files or script files.
- Role
Arn string - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- Object
Version string - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket String
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key String
- The name of the zip file that contains the build files or script files.
- role
Arn String - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object
Version String - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket string
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key string
- The name of the zip file that contains the build files or script files.
- role
Arn string - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object
Version string - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket str
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key str
- The name of the zip file that contains the build files or script files.
- role_
arn str - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object_
version str - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
- bucket String
- An Amazon S3 bucket identifier. This is the name of the S3 bucket.
- key String
- The name of the zip file that contains the build files or script files.
- role
Arn String - The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access the S3 bucket.
- object
Version String - The version of the file, if object versioning is turned on for the bucket. Amazon GameLift uses this information when retrieving files from your S3 bucket. To retrieve a specific version of the file, provide an object version. To retrieve the latest version of the file, do not set this parameter.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.