game_server_groups_list_only
Lists game_server_groups
in a region or regions, for all properties use game_server_groups
Overview
Name | game_server_groups_list_only |
Type | Resource |
Description | The AWS::GameLift::GameServerGroup resource creates an Amazon GameLift (GameLift) GameServerGroup. |
Id | aws.gamelift.game_server_groups_list_only |
Fields
Name | Datatype | Description |
---|---|---|
auto_scaling_group_arn | string | A generated unique ID for the EC2 Auto Scaling group that is associated with this game server group. |
auto_scaling_policy | object | Configuration 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_strategy | string | The 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_option | string | The type of delete to perform. |
game_server_group_arn | string | A generated unique ID for the game server group. |
game_server_group_name | string | An identifier for the new game server group. |
game_server_protection_policy | string | A flag that indicates whether instances in the game server group are protected from early termination. |
instance_definitions | array | A set of EC2 instance types to use when creating instances in the group. |
launch_template | object | The 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_size | number | The 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_size | number | The 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_arn | string | The Amazon Resource Name (ARN) for an IAM role that allows Amazon GameLift to access your EC2 Auto Scaling groups. |
tags | array | A 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_subnets | array | A 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. |
region | string | AWS region. |
Methods
Name | Accessible by | Required Params |
---|---|---|
list_resources | SELECT | region |
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