Referencia GameLift de API de Amazon service (AWSSDK)

En este tema se proporciona una lista basada en tareas de las operaciones de API para su uso con las soluciones de alojamiento GameLift gestionado de Amazon, incluido el alojamiento de servidores de juegos personalizados y servidores en tiempo real. Estas operaciones se empaquetan en elAWS SDK en el espacio deaws.gamelift nombres. Descargue elAWS SDK o consulte la documentación de referencia GameLift de la API de Amazon.

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

• Configura y administra los recursos de GameLift alojamiento de Amazon

• Inicia sesiones de juego y únete a los jugadores

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

Configura y administra los recursos de GameLift alojamiento de Amazon

Realice estas operaciones para configurar los recursos de alojamiento para sus servidores de juegos, escalar la capacidad para satisfacer la demanda de los jugadores, acceder a las métricas de rendimiento y uso, y mucho más. Estas operaciones de API se utilizan con servidores de juegos alojados en Amazon GameLift, incluidos los servidores en tiempo real. Puede utilizar la GameLift consola de Amazon para la mayoría de las tareas de administración de recursos o puede realizar llamadas al servicio mediante la herramientaAWS Command Line Interface (AWS CLI) o elAWS SDK.

Prepare los servidores de juegos para el despliegue

Carga y configura el código del servidor de juegos de tu juego para prepararlo para su despliegue y lanzamiento en los recursos de alojamiento.

Administra compilaciones de servidores de juegos personalizadas

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

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

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

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

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

• DeleteBuild— Eliminar una compilación de Amazon GameLift.

Gestione los scripts de configuración de Realtime Servers

• CreateScript— Cargue JavaScript archivos y cree un nuevo recurso de Amazon GameLift Script.

• ListScripts— Obtenga una lista de todos los scripts en tiempo real cargados en una GameLift región de Amazon.

• DescribeScript— Recuperar información asociada a un script en tiempo real.

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

• DeleteScript— Eliminar un script en tiempo real de Amazon GameLift.

Configure los recursos informáticos para el alojamiento

Configura los recursos de alojamiento e impleméntalos con la compilación del servidor del juego o el script de configuración en tiempo real.

Crear y gestionar flotas

• CreateFleet— Configure e implemente una nueva GameLift flota de recursos informáticos de Amazon para ejecutar sus servidores de juego. Una vez implementados, los servidores de juegos se lanzan automáticamente tal y como están configurados y listos para albergar sesiones de juego.

• ListFleets— Obtenga una lista de todas las flotas de una GameLift región amazónica.

• DeleteFleet— Elimina una flota que ya no utilice servidores de juegos ni aloje jugadores.

• Ver o actualizar las ubicaciones de la flota.

  • CreateFleetLocations— Agregue ubicaciones remotas a una flota existente que admita múltiples ubicaciones

  • DescribeFleetLocationAttributes— Obtenga una lista de todas las ubicaciones remotas de una flota y vea el estado actual de cada ubicación.

  • DeleteFleetLocations— Elimine las ubicaciones remotas de una flota que admita varias ubicaciones.

• Consulte o actualice las configuraciones de la flota.

  • DescribeFleetAttributes/UpdateFleetAttributes— Ver o cambiar los metadatos y la configuración de una flota para proteger las sesiones de juego y limitar la creación de recursos.

  • DescribeFleetPortSettings/UpdateFleetPortSettings— Vea o cambie los permisos de entrada (direcciones IP e intervalos de configuración de puertos) permitidos para una flota.

  • DescribeRuntimeConfiguration/UpdateRuntimeConfiguration— Vea o cambie los procesos de servidor que se van a ejecutar en cada instancia de una flota.

Gestione la capacidad de la flota

• DescribeEC2InstanceLimits: recupera el número máximo de instancias permitido para laAWS cuenta actual y el nivel de uso actual.

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

• DescribeFleetLocationCapacity— Recupera 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.

• Configure el auto-scaling:

  • PutScalingPolicy— Active el auto-scaling basado en objetivos, cree una política de auto-scaling personalizada o actualice una política existente.

  • DescribeScalingPolicies— Recuperar una política de auto-scaling existente.

  • DeleteScalingPolicy— Elimine una política de auto-scaling y evite que afecte a la capacidad de la flota.

  • StartFleetActions— Reiniciar las políticas de auto-scaling de una flota.

  • StopFleetActions— Suspender las políticas de auto-scaling de una flota.

Monitorice la actividad de la flota.

• DescribeFleetUtilization— Recupera estadísticas sobre el número de procesos del servidor, las sesiones de juego y los 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 del juego, incluido el tiempo de ejecución del juego y el recuento actual de jugadores.

Configurar colas para una ubicación óptima de la sesión 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.

• CreateGameSessionQueue— Crea una cola para utilizarla al procesar las solicitudes de ubicación en las sesiones de juego.

• DescribeGameSessionQueues— Recupera las colas de sesiones de juego definidas en una GameLift región de Amazon.

• UpdateGameSessionQueue— Cambiar la configuración de una cola de sesiones de juego.

• DeleteGameSessionQueue— Elimina una cola de sesiones 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— Defina un nuevo alias y asígnelo opcionalmente a una flota.

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

• 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 especificado.

Acceder a instancias de alojamiento

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, incluida la ID de la instancia, la dirección IP, la ubicación y el estado.

• GetInstanceAccess— Solicite las credenciales de acceso necesarias para conectarse de forma remota a una instancia específica de una flota.

Configurar las interconexiones de VPC

Crea y gestiona conexiones de interconexión de VPC entre tus recursos de GameLift alojamiento de Amazon y otrosAWS recursos.

• CreateVpcPeeringAuthorization— Autoriza una conexión de interconexión a una de tus VPC.

• DescribeVpcPeeringAuthorizations— Recupera las autorizaciones de conexión entre pares válidas.

• DeleteVpcPeeringAuthorization— Eliminar una autorización de conexión entre pares.

• CreateVpcPeeringConnection— Establezca una conexión de interconexión entre la VPC de una GameLift flota de Amazon y una de sus VPC.

• DescribeVpcPeeringConnections— Recupera información sobre las conexiones de interconexión de VPC activas o pendientes con una GameLift flota de Amazon.

• DeleteVpcPeeringConnection— Eliminar una conexión de interconexión de VPC con una GameLift flota de Amazon.

Inicia sesiones de juego y únete a los jugadores

Realiza estas operaciones desde el servicio de cliente del juego 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 se utilizan con servidores de juegos personalizados alojados en Amazon GameLift. Si utilizas servidores en tiempo real, gestiona las sesiones de juego mediante elReferencia a la API de cliente de Realtime Servers (C#).

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

  • StartGameSessionPlacement— Pide GameLift a Amazon que busque los mejores recursos de alojamiento disponibles e inicie una nueva sesión de juego. Este es el método preferido para crear nuevas sesiones de juego. Se basa en las colas de las sesiones de juego para rastrear la disponibilidad de alojamiento en varias regiones y utiliza los algoritmos de FleetIQ para priorizar las ubicaciones en función de la latencia de los jugadores, el costo de 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 te da un mayor control sobre dónde empezar la sesión de juego, en lugar de utilizar FleetIQ para evaluar las opciones de ubicación. Debes añadir jugadores a la nueva sesión de juego en un paso aparte.

• Haz que los jugadores participen en las sesiones de juego existentes. Encuentra sesiones de juego continuas con los espacios disponibles para jugadores y resérvalas para nuevos jugadores.

  • CreatePlayerSession— Reserva un espacio libre para que un jugador pueda unirse 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. Gestiona la información sobre las sesiones de juego y las sesiones de los jugadores.

  • SearchGameSessions— Solicita una lista de las sesiones de juego activas en función de un conjunto de criterios de búsqueda.

  • DescribeGameSessions— Recupera los metadatos de sesiones de juego específicas, incluido 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 del jugador, incluido 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— Obtiene la ubicación de los registros guardados para una sesión de juego.