AWS::GameLift::ContainerGroupDefinition

GameLift ContainerGroupDefinition

The AWS::GameLift::ContainerGroupDefinition resource creates an Amazon GameLift container group definition.

Properties

10 configurable properties. 4 required. Click a row to see details.

Filter:

Property	Type	Flags
`Name`	`string`	RequiredCreate-only
`OperatingSystem`	`string`	Required
`TotalMemoryLimitMebibytes`	`integer`	Required
`TotalVcpuLimit`	`number`	Required
`ContainerGroupType`	`string`	Create-only
`GameServerContainerDefinition`	`GameServerContainerDefinition`
`SourceVersionNumber`	`integer`	Write-only
`SupportContainerDefinitions`	`Array<SupportContainerDefinition>`
`Tags`	`Array<Tag>`
`VersionDescription`	`string`

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

Attribute	Type	Description
`ContainerGroupDefinitionArn`	`string`	The Amazon Resource Name (ARN) that is assigned to a Amazon GameLift container group resource and uniquely identifies it across all AWS Regions.
`CreationTime`	`string`	A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").
`Status`	`string`	A string indicating ContainerGroupDefinition status.
`StatusReason`	`string`	A string indicating the reason for ContainerGroupDefinition status.
`VersionNumber`	`integer`	The version of this ContainerGroupDefinition

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml

AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::GameLift::ContainerGroupDefinition

Resources:
  MyResource:
    Type: AWS::GameLift::ContainerGroupDefinition
    Properties:
      Name: "my-name"
      OperatingSystem: "AMAZON_LINUX_2023"
      TotalMemoryLimitMebibytes: 1
      TotalVcpuLimit: 1
      Tags:
        - Key: Environment
          Value: Production

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

gamelift:CreateContainerGroupDefinitiongamelift:DescribeContainerGroupDefinitiongamelift:ListTagsForResourcegamelift:TagResourceecr:BatchCheckLayerAvailabilityecr:BatchGetImageecr:GetDownloadUrlForLayerecr:DescribeImages

read

gamelift:DescribeContainerGroupDefinitiongamelift:ListTagsForResource

update

gamelift:DescribeContainerGroupDefinitiongamelift:UpdateContainerGroupDefinitiongamelift:ListTagsForResourcegamelift:TagResourcegamelift:UntagResource

delete

gamelift:DeleteContainerGroupDefinition

list

gamelift:ListContainerGroupDefinitions

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

ServiceGameLift

Properties15

Required4

TaggingSupported

Primary IDName

Supported Operations

CreateReadUpdateDeleteList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

NameContainerGroupType

Related Resources

External Links

AWS Documentation