CfnBuildProps

class aws_cdk.aws_gamelift.CfnBuildProps(*, name=None, operating_system=None, server_sdk_version=None, storage_location=None, version=None)

Bases: object

Properties for defining a CfnBuild.

Parameters:

name (Optional[str]) – A descriptive label that is associated with a build. Build names do not need to be unique.
operating_system (Optional[str]) – The operating system that your game server binaries run on. This value determines the type of fleet resources that you use for this build. If your game build contains multiple executables, they all must run on the same operating system. You must specify a valid operating system in this request. There is no default value. You can’t change a build’s operating system later. .. epigraph:: Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the Amazon Linux 2 FAQs . For game servers that are hosted on AL2 and use Amazon GameLift server SDK 4.x., first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See Migrate to Amazon GameLift server SDK version 5.
server_sdk_version (Optional[str]) – A server SDK version you used when integrating your game server build with Amazon GameLift. For more information see Integrate games with custom game servers . By default Amazon GameLift sets this value to 4.0.2 .
storage_location (Union[IResolvable, StorageLocationProperty, Dict[str, Any], None]) – 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. If a StorageLocation is specified, the size of your file can be found in your Amazon S3 bucket. Amazon GameLift will report a SizeOnDisk of 0.
version (Optional[str]) – Version information that is associated with this build. Version strings do not need to be unique.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-build.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_gamelift as gamelift

cfn_build_props = gamelift.CfnBuildProps(
    name="name",
    operating_system="operatingSystem",
    server_sdk_version="serverSdkVersion",
    storage_location=gamelift.CfnBuild.StorageLocationProperty(
        bucket="bucket",
        key="key",
        role_arn="roleArn",

        # the properties below are optional
        object_version="objectVersion"
    ),
    version="version"
)

Attributes

name

A descriptive label that is associated with a build.

Build names do not need to be unique.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-build.html#cfn-gamelift-build-name

operating_system

The operating system that your game server binaries run on.

This value determines the type of fleet resources that you use for this build. If your game build contains multiple executables, they all must run on the same operating system. You must specify a valid operating system in this request. There is no default value. You can’t change a build’s operating system later. .. epigraph:

Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the `Amazon Linux 2 FAQs <https://docs.aws.amazon.com/https://aws.amazon.com/amazon-linux-2/faqs/>`_ . For game servers that are hosted on AL2 and use Amazon GameLift server SDK 4.x., first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See `Migrate to Amazon GameLift server SDK version 5. <https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html>`_

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-build.html#cfn-gamelift-build-operatingsystem

server_sdk_version

A server SDK version you used when integrating your game server build with Amazon GameLift.

For more information see Integrate games with custom game servers . By default Amazon GameLift sets this value to 4.0.2 .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-build.html#cfn-gamelift-build-serversdkversion

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.

If a StorageLocation is specified, the size of your file can be found in your Amazon S3 bucket. Amazon GameLift will report a SizeOnDisk of 0.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-build.html#cfn-gamelift-build-storagelocation

version

Version information that is associated with this build.

Version strings do not need to be unique.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-gamelift-build.html#cfn-gamelift-build-version