{ "$schema": "https://json-structure.org/meta/core/v0/#", "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-gamelift/refs/heads/main/json-structure/gamelift-game-session-connection-info-structure.json", "name": "GameSessionConnectionInfo", "description": "Connection information for a new game session that is created in response to a start matchmaking request. Once a match is made, the FlexMatch engine creates a new game session for it. This information, including the game session endpoint and player sessions for each player in the original matchmaking request, is added to the matchmaking ticket.", "type": "object", "properties": { "GameSessionArn": { "allOf": [ { "$ref": "#/components/schemas/ArnStringModel" }, { "description": "A unique identifier for the game session. Use the game session ID." } ] }, "IpAddress": { "allOf": [ { "$ref": "#/components/schemas/IpAddress" }, { "description": "The IP address of the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number." } ] }, "DnsName": { "allOf": [ { "$ref": "#/components/schemas/DnsName" }, { "description": "
The DNS identifier assigned to the instance that is running the game session. Values have the following format:
TLS-enabled fleets: <unique identifier>.<region identifier>.amazongamelift.com.
Non-TLS-enabled fleets: ec2-<unique identifier>.compute.amazonaws.com. (See Amazon EC2 Instance IP Addressing.)
When connecting to a game session that is running on a TLS-enabled fleet, you must use the DNS name, not the IP address.
" } ] }, "Port": { "allOf": [ { "$ref": "#/components/schemas/PositiveInteger" }, { "description": "The port number for the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number." } ] }, "MatchedPlayerSessions": { "allOf": [ { "$ref": "#/components/schemas/MatchedPlayerSessionList" }, { "description": "A collection of player session IDs, one for each player ID that was included in the original matchmaking request. " } ] } } }