Amazon GameLift · JSON Structure

Gamelift Start Matchmaking Input Structure

StartMatchmakingInput schema from Amazon GameLift API

Type: object Properties: 3 Required: 2
Cloud ComputingGame ServersGamingMultiplayerMatchmakingFlexMatchFleetIQ

StartMatchmakingInput is a JSON Structure definition published by Amazon GameLift, describing 3 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

TicketId ConfigurationName Players

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-gamelift/refs/heads/main/json-structure/gamelift-start-matchmaking-input-structure.json",
  "name": "StartMatchmakingInput",
  "description": "StartMatchmakingInput schema from Amazon GameLift API",
  "type": "object",
  "properties": {
    "TicketId": {
      "allOf": [
        {
          "$ref": "#/components/schemas/MatchmakingIdStringModel"
        },
        {
          "description": "A unique identifier for a matchmaking ticket. If no ticket ID is specified here, Amazon GameLift will generate one in the form of a UUID. Use this identifier to track the matchmaking ticket status and retrieve match results."
        }
      ]
    },
    "ConfigurationName": {
      "allOf": [
        {
          "$ref": "#/components/schemas/MatchmakingConfigurationName"
        },
        {
          "description": "Name of the matchmaking configuration to use for this request. Matchmaking configurations must exist in the same Region as this request. You can use either the configuration name or ARN value."
        }
      ]
    },
    "Players": {
      "allOf": [
        {
          "$ref": "#/components/schemas/PlayerList"
        },
        {
          "description": "<p>Information on each player to be matched. This information must include a player ID, and may contain player attributes and latency data to be used in the matchmaking process. After a successful match, <code>Player</code> objects contain the name of the team the player is assigned to.</p> <p>You can include up to 10 <code>Players</code> in a <code>StartMatchmaking</code> request.</p>"
        }
      ]
    }
  },
  "required": [
    "ConfigurationName",
    "Players"
  ]
}