Skip to main content

game_server_groups_list_only

Lists game_server_groups in a region or regions, for all properties use game_server_groups

Overview

Namegame_server_groups_list_only
TypeResource
DescriptionThe AWS::GameLift::GameServerGroup resource creates an Amazon GameLift (GameLift) GameServerGroup.
Idaws.gamelift.game_server_groups_list_only

Fields

NameDatatypeDescription
auto_scaling_group_arnstringA generated unique ID for the EC2 Auto Scaling group that is associated with this game server group.
auto_scaling_policyobjectConfiguration settings to define a scaling policy for the Auto Scaling group that is optimized for game hosting. Updating this game server group property will not take effect for the created EC2 Auto Scaling group, please update the EC2 Auto Scaling group directly after creating the resource.
balancing_strategystringThe fallback balancing method to use for the game server group when Spot Instances in a Region become unavailable or are not viable for game hosting.
delete_optionstringThe type of delete to perform.
game_server_group_arnstringA generated unique ID for the game server group.
game_server_group_namestringAn identifier for the new game server group.
game_server_protection_policystringA flag that indicates whether instances in the game server group are protected from early termination.
instance_definitionsarrayA set of EC2 instance types to use when creating instances in the group.
launch_templateobjectThe EC2 launch template that contains configuration settings and game server code to be deployed to all instances in the game server group. Updating this game server group property will not take effect for the created EC2 Auto Scaling group, please update the EC2 Auto Scaling group directly after creating the resource.
max_sizenumberThe maximum number of instances allowed in the EC2 Auto Scaling group. Updating this game server group property will not take effect for the created EC2 Auto Scaling group, please update the EC2 Auto Scaling group directly after creating the resource.
min_sizenumberThe minimum number of instances allowed in the EC2 Auto Scaling group. Updating this game server group property will not take effect for the created EC2 Auto Scaling group, please update the EC2 Auto Scaling group directly after creating the resource.
role_arnstringThe Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access your EC2 Auto Scaling groups.
tagsarrayA list of labels to assign to the new game server group resource. Updating game server group tags with CloudFormation will not take effect. Please update this property using AWS GameLift APIs instead.
vpc_subnetsarrayA list of virtual private cloud (VPC) subnets to use with instances in the game server group. Updating this game server group property will not take effect for the created EC2 Auto Scaling group, please update the EC2 Auto Scaling group directly after creating the resource.
regionstringAWS region.

Methods

NameAccessible byRequired Params
list_resourcesSELECTregion

SELECT examples

Lists all game_server_groups in a region.

SELECT
region,
game_server_group_arn
FROM aws.gamelift.game_server_groups_list_only
WHERE region = 'us-east-1';

Permissions

For permissions required to operate on the game_server_groups_list_only resource, see game_server_groups