:doc:`GameLift <../../gamelift>` / Client / deregister_game_server

**********************
deregister_game_server
**********************



.. py:method:: GameLift.Client.deregister_game_server(**kwargs)

  

  **This API works with the following fleet types:** EC2 (FleetIQ)

   

  Removes the game server from a game server group. As a result of this operation, the deregistered game server can no longer be claimed and will not be returned in a list of active game servers.

   

  To deregister a game server, specify the game server group and game server ID. If successful, this operation emits a CloudWatch event with termination timestamp and reason.

   

  **Learn more**

   

  `Amazon GameLift Servers FleetIQ Guide <https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html>`__

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeregisterGameServer>`_  


  **Request Syntax**
  ::

    response = client.deregister_game_server(
        GameServerGroupName='string',
        GameServerId='string'
    )
    
  :type GameServerGroupName: string
  :param GameServerGroupName: **[REQUIRED]** 

    A unique identifier for the game server group where the game server is running.

    

  
  :type GameServerId: string
  :param GameServerId: **[REQUIRED]** 

    A custom string that uniquely identifies the game server to deregister.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`GameLift.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`GameLift.Client.exceptions.NotFoundException`

  
  *   :py:class:`GameLift.Client.exceptions.UnauthorizedException`

  
  *   :py:class:`GameLift.Client.exceptions.InternalServiceException`

  