Amazon GameLift · JSON Structure

Gamelift Describe Player Sessions Input Structure

DescribePlayerSessionsInput schema from Amazon GameLift API

Type: object Properties: 6
Cloud ComputingGame ServersGamingMultiplayerMatchmakingFlexMatchFleetIQ

DescribePlayerSessionsInput is a JSON Structure definition published by Amazon GameLift, describing 6 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

GameSessionId PlayerId PlayerSessionId PlayerSessionStatusFilter Limit NextToken

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-describe-player-sessions-input-structure.json",
  "name": "DescribePlayerSessionsInput",
  "description": "DescribePlayerSessionsInput schema from Amazon GameLift API",
  "type": "object",
  "properties": {
    "GameSessionId": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ArnStringModel"
        },
        {
          "description": "A unique identifier for the game session to retrieve player sessions for."
        }
      ]
    },
    "PlayerId": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NonZeroAndMaxString"
        },
        {
          "description": "A unique identifier for a player to retrieve player sessions for."
        }
      ]
    },
    "PlayerSessionId": {
      "allOf": [
        {
          "$ref": "#/components/schemas/PlayerSessionId"
        },
        {
          "description": "A unique identifier for a player session to retrieve."
        }
      ]
    },
    "PlayerSessionStatusFilter": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NonZeroAndMaxString"
        },
        {
          "description": "<p>Player session status to filter results on. Note that when a PlayerSessionId or PlayerId is provided in a DescribePlayerSessions request, then the PlayerSessionStatusFilter has no effect on the response.</p> <p>Possible player session statuses include the following:</p> <ul> <li> <p> <b>RESERVED</b> -- The player session request has been received, but the player has not yet connected to the server process and/or been validated. </p> </li> <li> <p> <b>ACTIVE</b> -- The player has been validated by the server process and is currently connected.</p> </li> <li> <p> <b>COMPLETED</b> -- The player connection has been dropped.</p> </li> <li> <p> <b>TIMEDOUT</b> -- A player session request was received, but the player did not connect and/or was not validated within the timeout limit (60 seconds).</p> </li> </ul>"
        }
      ]
    },
    "Limit": {
      "allOf": [
        {
          "$ref": "#/components/schemas/PositiveInteger"
        },
        {
          "description": "The maximum number of results to return. Use this parameter with <code>NextToken</code> to get results as a set of sequential pages. If a player session ID is specified, this parameter is ignored."
        }
      ]
    },
    "NextToken": {
      "allOf": [
        {
          "$ref": "#/components/schemas/NonZeroAndMaxString"
        },
        {
          "description": "A token that indicates the start of the next sequential page of results. Use the token that is returned with a previous call to this operation. To start at the beginning of the result set, do not specify a value. If a player session ID is specified, this parameter is ignored."
        }
      ]
    }
  }
}