Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws ]



Amazon GameLift is a managed service for developers who need a scalable, dedicated server solution for their multiplayer games. Amazon GameLift provides tools to acquire computing resources and deploy game servers, scale game server capacity to meet player demand, and track in-depth metrics on player usage and server performance.

The Amazon GameLift service API includes important features:

  • Find game sessions and match players to games – Retrieve information on available game sessions; create new game sessions; send player requests to join a game session.
  • Configure and manage game server resources – Manage builds, fleets, queues, and aliases; set autoscaling policies; retrieve logs and metrics.

This reference guide describes the low-level service API for Amazon GameLift. We recommend using either the Amazon Web Services software development kit (AWS SDK ), available in multiple languages, or the AWS command-line interface (CLI) tool. Both of these align with the low-level service API. In addition, you can use the AWS Management Console for Amazon GameLift for many administrative actions.

You can use some API actions with Amazon GameLift Local, a testing tool that lets you test your game integration locally before deploying on Amazon GameLift. You can call these APIs from the AWS CLI or programmatically; API calls to Amazon GameLift Local servers perform exactly as they do when calling Amazon GameLift web servers. For more information on using Amazon GameLift Local, see Testing an Integration .


This list offers a functional overview of the Amazon GameLift service API.

Finding Games and Joining Players

You can enable players to connect to game servers on Amazon GameLift from a game client or through a game service (such as a matchmaking service). You can use these operations to discover actively running game or start new games. You can also match players to games, either singly or as a group.

  • Discover existing game sessions
    • search-game-sessions – Get all available game sessions or search for game sessions that match a set of criteria. Available in Amazon GameLift Local.
  • Start a new game session
    • Game session placement – Use a queue to process new game session requests and create game sessions on fleets designated for the queue.
      • start-game-session-placement – Request a new game session placement and add one or more players to it.
      • describe-game-session-placement – Get details on a placement request, including status.
      • stop-game-session-placement – Cancel a placement request.
    • create-game-session – Start a new game session on a specific fleet. Available in Amazon GameLift Local.
  • Manage game session objects
    • describe-game-sessions – Retrieve metadata for one or more game sessions, including length of time active and current player count. Available in Amazon GameLift Local.
    • describe-game-session-details – Retrieve metadata and the game session protection setting for one or more game sessions.
    • update-game-session – Change game session settings, such as maximum player count and join policy.
    • get-game-session-log-url – Get the location of saved logs for a game session.
  • Manage player sessions objects
    • create-player-session – Send a request for a player to join a game session. Available in Amazon GameLift Local.
    • create-player-sessions – Send a request for multiple players to join a game session. Available in Amazon GameLift Local.
    • describe-player-sessions – Get details on player activity, including status, playing time, and player data. Available in Amazon GameLift Local.
Setting Up and Managing Game Servers

When setting up Amazon GameLift, first create a game build and upload the files to Amazon GameLift. Then use these operations to set up a fleet of resources to run your game servers. Manage games to scale capacity, adjust configuration settings, access raw utilization data, and more.

  • Manage game builds
    • create-build – Create a new build by uploading files stored in an Amazon S3 bucket. (To create a build stored at a local file location, use the AWS CLI command upload-build .)
    • list-builds – Get a list of all builds uploaded to a Amazon GameLift region.
    • describe-build – Retrieve information associated with a build.
    • update-build – Change build metadata, including build name and version.
    • delete-build – Remove a build from Amazon GameLift.
  • Manage fleets
    • create-fleet – Configure and activate a new fleet to run a build's game servers.
    • delete-fleet – Terminate a fleet that is no longer running game servers or hosting players.
    • View / update fleet configurations.
      • list-fleets – Get a list of all fleet IDs in a Amazon GameLift region (all statuses).
      • describe-fleet-attributes / update-fleet-attributes – View or change a fleet's metadata and settings for game session protection and resource creation limits.
      • describe-fleet-port-settings / update-fleet-port-settings – View or change the inbound permissions (IP address and port setting ranges) allowed for a fleet.
      • describe-runtime-configuration / update-runtime-configuration – View or change what server processes (and how many) to run on each instance in a fleet.
      • describe-instances – Get information on each instance in a fleet, including instance ID, IP address, and status.
  • Control fleet capacity
    • describe-ec2-instance-limits – Retrieve maximum number of instances allowed for the current AWS account and the current usage level.
    • describe-fleet-capacity / update-fleet-capacity – Retrieve the capacity settings and the current number of instances in a fleet; adjust fleet capacity settings to scale up or down.
    • Autoscale – Manage autoscaling rules and apply them to a fleet.
      • put-scaling-policy – Create a new autoscaling policy, or update an existing one.
      • describe-scaling-policies – Retrieve an existing autoscaling policy.
      • delete-scaling-policy – Delete an autoscaling policy and stop it from affecting a fleet's capacity.
  • Access fleet activity statistics
    • describe-fleet-utilization – Get current data on the number of server processes, game sessions, and players currently active on a fleet.
    • describe-fleet-events – Get a fleet's logged events for a specified time span.
    • describe-game-sessions – Retrieve metadata associated with one or more game sessions, including length of time active and current player count.
  • Remotely access an instance
    • get-instance-access – Request access credentials needed to remotely connect to a specified instance in a fleet.
  • Manage fleet aliases
    • create-alias – Define a new alias and optionally assign it to a fleet.
    • list-aliases – Get all fleet aliases defined in a Amazon GameLift region.
    • describe-alias – Retrieve information on an existing alias.
    • update-alias – Change settings for a alias, such as redirecting it from one fleet to another.
    • delete-alias – Remove an alias from the region.
    • resolve-alias – Get the fleet ID that a specified alias points to.
  • Manage game session queues
    • create-game-session-queue – Create a queue for processing requests for new game sessions.
    • describe-game-session-queues – Get data on all game session queues defined in a Amazon GameLift region.
    • update-game-session-queue – Change the configuration of a game session queue.
    • delete-game-session-queue – Remove a game session queue from the region.