API de servicio de Amazon GameLift - Amazon GameLift
Administración de los recursos de alojamiento de Amazon GameLiftInicio de sesiones de juego y unión de los jugadores

API de servicio de Amazon GameLift

Utilice esta lista basada en tareas para buscar las operaciones de API al crear las soluciones de alojamiento de juegos de Amazon GameLift y otras características. El AWS SDK incluye estas operaciones en el espacio de nombres de aws.gamelift. Descargue el SDK de AWS o consulte la documentación de referencia de la API de Amazon GameLift. También puede usar la API con la interfaz de línea de comandos (AWS CLI), tal y como se explica en la Referencia de comandos de la AWS CLI.

La API incluye dos conjuntos de operaciones para el alojamiento administrado de juegos:

La API del servicio de Amazon GameLift también contiene operaciones para su uso con otras herramientas y soluciones de Amazon GameLift. Para obtener una lista de las API de FleetIQ, consulte las operaciones de API de FleetIQ. Para obtener una lista de las API de FlexMatch para el emparejamiento, consulte las operaciones de API de FlexMatch.

Administración de los recursos de alojamiento de Amazon GameLift

Llame a estas operaciones para configurar los recursos de alojamiento para sus servidores de juegos, escalar la capacidad para satisfacer la demanda de jugadores, obtener métricas de rendimiento y utilización, etc. Utilice estas operaciones de API para alojar servidores de juegos con Amazon GameLift, lo que incluye Servidores en tiempo real. Puede utilizar la consola de Amazon GameLift para la mayoría de las tareas de administración de recursos, o puede hacer llamadas con la herramienta AWS Command Line Interface (AWS CLI).

Preparación de servidores de juegos para la implementación

Cargue y configure el código del servidor de juegos del juego para prepararlo para su implementación y lanzamiento en los recursos de alojamiento.

Administración de compilaciones de servidores de juegos personalizados

  • upload-build: permite cargar archivos de compilación desde una ruta local y crear un nuevo recurso de compilación de Amazon GameLift. Esta operación, disponible solo como un comando de la AWS CLI, es el método más común para cargar compilaciones de servidores de juegos.

  • CreateBuild: permite crear una nueva compilación de juego utilizando archivos almacenados en un bucket de Amazon S3.

  • ListBuilds: permite obtener una lista de todas las compilaciones cargadas en una región de Amazon GameLift.

  • DescribeBuild: permite recuperar la información asociada a una compilación.

  • UpdateBuild: permite cambiar los metadatos de la compilación, incluidos el nombre y la versión de la compilación.

  • DeleteBuild: permite eliminar una compilación de Amazon GameLift.

Administración de los scripts de configuración de Servidores en tiempo real

  • CreateScript: permite cargar archivos JavaScript y crear un nuevo recurso de script de Amazon GameLift.

  • ListScripts: permite obtener una lista de todos los scripts cargados en una región de Amazon GameLift.

  • DescribeScript: permite recuperar la información asociada a un script de Realtime.

  • Updatescript: permite cambiar los metadatos del script y cargar el contenido del script revisado.

  • DeleteScript: permite eliminar un script de Realtime de Amazon GameLift.

Configuración de los recursos informáticos para el alojamiento

Configure los recursos de alojamiento e impleméntelos con la compilación del servidor de juegos o el script de configuración de Realtime.

Creación y administración de flotas

  • CreateFleet: permite configurar e implementar una nueva flota de recursos informáticos de Amazon GameLift para ejecutar sus servidores de juego. Una vez implementados, los servidores de juegos se lanzan automáticamente según estén configurados y preparados para alojar sesiones de juego.

  • ListFleets: permite obtener una lista de todas las flotas de una región de Amazon GameLift.

  • DeleteFleet: elimina una flota que ya no ejecuta servidores de juegos ni aloja jugadores.

  • Visualización/actualización de las ubicaciones de la flota

    • CreateFleetLocations: permite añadir ubicaciones remotas a una flota existente que admite varias ubicaciones.

    • DescribeFleetLocationAttributes: permite obtener una lista de todas las ubicaciones remotas de una flota y ver el estado actual de cada ubicación.

    • DeleteFleetLocations: permite eliminar las ubicaciones remotas de una flota que admite varias ubicaciones.

  • Consulte o actualice las configuraciones de la flota.

Administración de la capacidad de la flota

  • DescribeEC2InstanceLimits: permite recuperar el número máximo de instancias permitido para la cuenta de AWS actual y el nivel de uso actual.

  • DescribeFleetCapacity: permite recuperar la configuración de la capacidad actual de la región de origen de una flota.

  • DescribeFleetLocationCapacity: permite recuperar la configuración de capacidad actual de cada ubicación de una flota con varias ubicaciones.

  • UpdatefleetCapacity: permite ajusta manualmente la configuración de la capacidad de una flota.

  • Configure :

    • PutsCalingPolicy: permite activar el escalado automático basado en objetivos, crear una política de escalado automático personalizada o actualizar una política existente.

    • DescribEscalingPolicies: permite recuperar una política de escalado automático existente.

    • DeletEscalingPolicy: permite eliminar una política de escalado automático y evitar que afecte a la capacidad de la flota.

    • StartFleetActions: permite reiniciar políticas de escalado automático de una flota.

    • StopFleetActions: permite suspender las políticas de escalado automático de una flota.

Monitorice la actividad de la flota.

  • DescribeFleetUtilization: permite recuperar estadísticas sobre la cantidad de procesos del servidor, sesiones de juego y jugadores que están activos actualmente en una flota.

  • DescribeFleetLocationUtilization: permite recuperar las estadísticas de utilización de cada ubicación en una flota con varias ubicaciones.

  • DescribeFleetEvents: permite ver los eventos registrados de una flota durante un periodo específico.

  • DescribeGamessions: permite recuperar los metadatos de las sesiones de juego, incluido el tiempo de ejecución de un juego y el número actual de jugadores.

Configuración de colas para la ubicación de sesiones de juego

Configure colas de varias flotas y regiones para colocar las sesiones de juego con los mejores recursos de alojamiento disponibles en cuanto a costo, latencia y resiliencia.

  • CreateGamessionQueue: permite crear una cola para usarla al procesar las solicitudes de ubicación de las sesiones de juego.

  • DescribeGamessionQueues: permite recuperar las colas de sesiones de juego definidas en una región de Amazon GameLift.

  • UpdateGamessionQueue: permite cambiar la configuración de una cola de sesión de juego.

  • DeleteGamessionQueue: permite eliminar una cola de sesión de juego de la región.

Administrar alias

Utilice alias para representar sus flotas o crear un destino alternativo de terminal. Los alias son útiles cuando se pasa la actividad del juego de una flota a otra, como durante las actualizaciones de compilación del servidor de juegos.

  • CreateAlias: permite definir un nuevo alias y, si lo desea, asignarlo a una flota.

  • ListAliases: permite obtener todos los alias de flota definidos en una región de Amazon GameLift.

  • describeAlias: permite recuperar información sobre un alias existente.

  • UpdateAlias: permite cambiar la configuración de un alias, por ejemplo, redirigirlo de una flota a otra.

  • DeleteAlias: permite eliminar un alias de la región.

  • resolveAlias: permite obtener el ID de la flota al que apunta un alias específico.

Conexión a instancias de alojamiento administrado

Consulte información sobre las distintas instancias de una flota o solicite el acceso remoto a la instancia de una flota especificada para solucionar problemas.

  • DescribeInstances: permite obtener información sobre cada instancia de una flota, incluidos el ID de la instancia, la dirección IP, la ubicación y el estado.

  • GetInstanceAccess: permite solicitar las credenciales de acceso necesarias para conectarse de forma remota a una instancia específica de una flota.

Configurar las interconexiones de VPC

Cree y administre conexiones de emparejamiento de VPC entre sus recursos de alojamiento de Amazon GameLift y otros recursos de AWS.

Inicio de sesiones de juego y unión de los jugadores

Llame a estas operaciones desde un servicio de backend para iniciar nuevas sesiones de juego, obtener información sobre las sesiones de juego existentes y unir a los jugadores a las sesiones de juego. Estas operaciones son para los servidores de juegos personalizados alojados en Amazon GameLift. Si utiliza Servidores en tiempo real, administra las sesiones de juego mediante el Referencia de la API de cliente de Servidores en tiempo real (C#).

  • Inicie nuevas sesiones de juego para uno o varios jugadores.

    • StartGamessionPlacement: permite solicitar a Amazon GameLift que busque los mejores recursos de alojamiento disponibles e iniciar una nueva sesión de juego. Este es el método preferido para crear nuevas sesiones de juego. Se basa en las colas de sesiones de juego para realizar un seguimiento de la disponibilidad del alojamiento en varias regiones y utilizar los algoritmos de FleetIQ para priorizar las ubicaciones en función de la latencia de los jugadores, el costo del alojamiento, la ubicación, etc.

    • DescribeGamessionPlacement: permite obtener los detalles y el estado de una solicitud de ubicación.

    • StopGamessionPlacement: permite cancelar una solicitud de ubicación.

    • CreateGamesession: permite iniciar una nueva sesión de juego vacía en una ubicación de flota específica. Esta operación le proporciona un mayor control sobre dónde iniciar la sesión de juego en lugar de utilizar FleetIQ para evaluar las opciones de ubicación. Debe añadir jugadores a la nueva sesión de juego en un paso aparte.

  • Coloque a los jugadores en sesiones de juego existentes. Busque sesiones de juego en ejecución con ranuras de jugador disponibles y resérvelas para nuevos jugadores.

    • CreatePlayerSession: permite reservar una ranura libre para que un jugador se una a una sesión de juego.

    • CreatePlayerSessions: permite reservar ranuras abiertas para que varios jugadores se unan a una sesión de juego.

  • Trabaje con datos de sesiones de juego y de jugador. Administración de información sobre sesiones de juego y sesiones de jugador

    • SearchGamesessions: permite solicitar una lista de las sesiones de juego activas en función de un conjunto de criterios de búsqueda.

    • DescribeGamessions: permite recuperar los metadatos de las sesiones de juego específicas, incluido el tiempo de activación y el número actual de jugadores.

    • DescribeGamessionDetails: permite recuperar los metadatos, incluida la configuración de protección de la sesión de juego de una o más sesiones de juego.

    • DescribePlayerSessions: permite obtener información sobre la actividad de los jugadores, incluidos el estado, el tiempo de juego y los datos del jugador.

    • UpdateGameSession: permite cambiar la configuración de la sesión de juego, como el número máximo de jugadores y la política de unión.

    • GetGamessionLogurl: permite obtener la ubicación de los registros almacenados para una sesión de juego.