View a markdown version of this page

API de servicio para GameLift Servidores Amazon - GameLift Servidores Amazon
Administración GameLift Servidores Amazon recursos de alojamientoInicio de sesiones de juego y unión de los jugadores

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

API de servicio para GameLift Servidores Amazon

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

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

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

Administración GameLift Servidores Amazon recursos de alojamiento

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 Servers, incluidos Amazon GameLift Servers Realtime. También puede trabajar en la consola de Amazon GameLift Servers en la mayoría de las tareas de administración de recursos, o puede realizar 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 Servers. Esta operación, disponible como AWS CLI comando, es la forma más común de subir compilaciones de servidores de juegos.

  • CreateBuild— Cree una nueva compilación con los archivos almacenados en un bucket de Amazon S3.

  • ListBuilds— Obtenga una lista de todas las compilaciones subidas a una Amazon GameLift Servers región.

  • DescribeBuild— Recuperar la información asociada a una compilación.

  • UpdateBuild— Cambia los metadatos de la compilación, incluidos el nombre y la versión de la compilación.

  • DeleteBuild— Eliminar una compilación deAmazon GameLift Servers.

Administración de scripts de configuración de Amazon GameLift Servers Realtime

  • CreateScript— Subir JavaScript archivos y crear un nuevo recurso de Amazon GameLift Servers script.

  • ListScripts— Obtener una lista de todos los Realtime scripts subidos a una Amazon GameLift Servers región.

  • DescribeScript— Recuperar la información asociada a un Realtime script.

  • UpdateScript— Cambiar los metadatos del guion y cargar el contenido revisado del guion.

  • DeleteScript— Eliminar un Realtime guion deAmazon GameLift Servers.

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— Configure e implemente una nueva Amazon GameLift Servers flota de recursos informáticos para ejecutar sus servidores de juegos. Una vez implementados, los servidores de juegos se lanzan automáticamente según estén configurados y preparados para alojar sesiones de juego.

  • ListFleets— Obtenga una lista de todas las flotas de una Amazon GameLift Servers región.

  • DeleteFleet— Elimina una flota que ya no tenga servidores de juego ni aloje jugadores.

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

  • Consulte o actualice las configuraciones de la flota.

Administración de la capacidad de la flota

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

  • DescribeFleetCapacity— Recupere la configuración de capacidad actual de la región de origen de una flota.

  • DescribeFleetLocationCapacity— Recupere la configuración de capacidad actual para cada ubicación de una flota con varias ubicaciones.

  • UpdateFleetCapacity— Ajustar manualmente la configuración de capacidad de una flota.

  • Configurar:

    • PutScalingPolicy— Activa el escalado automático basado en objetivos, crea una política de escalado automático personalizada o actualiza una política existente.

    • DescribeScalingPolicies— Recuperar una política de escalado automático existente.

    • DeleteScalingPolicy— Elimine una política de escalado automático y evite que afecte a la capacidad de una flota.

    • StartFleetActions— Reiniciar las políticas de escalado automático de una flota.

    • StopFleetActions— Suspender las políticas de escalado automático de una flota.

Monitorice la actividad de la flota.

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

  • DescribeFleetLocationUtilization— Recupere las estadísticas de utilización de cada ubicación de una flota con varias ubicaciones.

  • DescribeFleetEvents— Ver los eventos registrados de una flota durante un período de tiempo específico.

  • DescribeGameSessions— Recupera los metadatos de la sesión de juego, incluidos el tiempo de ejecución de un juego y el recuento 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.

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— Defina un nuevo alias y, si lo desea, asígnelo a una flota.

  • ListAliases— Obtenga todos los alias de flota definidos en una Amazon GameLift Servers región.

  • DescribeAlias— Recuperar información sobre un alias existente.

  • UpdateAlias— Cambiar la configuración de un alias, por ejemplo, redirigirlo de una flota a otra.

  • DeleteAlias— Eliminar un alias de la región.

  • ResolveAlias— Obtenga el ID de 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— Obtenga 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— Solicita las credenciales de acceso necesarias para conectarte de forma remota a una instancia específica de una flota.

Configurar las interconexiones de VPC

Crea y administra conexiones de interconexión de VPC entre tus recursos de Amazon GameLift Servers alojamiento y otros AWS recursos.

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 su uso con servidores de juegos personalizados alojados en Amazon GameLift Servers. Si está utilizando Amazon GameLift Servers Realtime, administre las sesiones de juego mediante la API de cliente de Amazon GameLift Servers Realtime (C#).

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

    • StartGameSessionPlacement— Pide Amazon GameLift Servers encontrar los mejores recursos de alojamiento disponibles e inicia 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.

    • DescribeGameSessionPlacement— Obtenga los detalles y el estado de una solicitud de colocación.

    • StopGameSessionPlacement— Cancelar una solicitud de colocación.

    • CreateGameSession— Inicia una nueva sesión de juego vacía en una ubicación específica de la flota. 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— Reserva un espacio abierto para que un jugador se una a una sesión de juego.

    • CreatePlayerSessions— Reserva espacios abiertos 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— Solicita una lista de las sesiones de juego activas según un conjunto de criterios de búsqueda.

    • DescribeGameSessions— Recupera los metadatos de sesiones de juego específicas, incluidos el tiempo de actividad y el recuento actual de jugadores.

    • DescribeGameSessionDetails— Recupera los metadatos, incluida la configuración de protección de la sesión de juego, de una o más sesiones de juego.

    • DescribePlayerSessions— Obtén detalles sobre la actividad de los jugadores, incluidos el estado, el tiempo de juego y los datos del jugador.

    • UpdateGameSession— Cambia la configuración de la sesión de juego, como el número máximo de jugadores y la política de registro.

    • GetGameSessionLogUrl— Obtenga la ubicación de los registros guardados para una sesión de juego.