GameServerInstance
This data type is used with the Amazon GameLift FleetIQ and game server groups.
Additional properties,
including status, that describe an EC2 instance in a game server group. Instance
configurations are set with game server group properties (see
DescribeGameServerGroup
and with the EC2 launch template that was used
when creating the game server group.
Retrieve game server instances for a game server group by calling
DescribeGameServerInstances
.
Contents
Note
In the following list, the required parameters are described first.
- GameServerGroupArn
-
A generated unique identifier for the game server group that includes the game server instance.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 256.
Pattern:
^arn:.*:gameservergroup\/[a-zA-Z0-9-\.]*
Required: No
- GameServerGroupName
-
A developer-defined identifier for the game server group that includes the game server instance. The name is unique for each Region in each AWS account.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
[a-zA-Z0-9-\.]+
Required: No
- InstanceId
-
The unique identifier for the instance where the game server is running. This ID is available in the instance metadata. EC2 instance IDs use a 17-character format, for example:
i-1234567890abcdef0
.Type: String
Length Constraints: Fixed length of 19.
Pattern:
^i-[0-9a-zA-Z]{17}$
Required: No
- InstanceStatus
-
Current status of the game server instance
Type: String
Valid Values:
ACTIVE | DRAINING | SPOT_TERMINATING
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: