View a markdown version of this page

API de service pour GameLift Serveurs Amazon - GameLift Serveurs Amazon
Gérer GameLift Serveurs Amazon ressources d'hébergementDémarrez des sessions de jeu et rejoignez des joueurs

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

API de service pour GameLift Serveurs Amazon

Utilisez cette liste basée sur les tâches pour trouver les opérations d'API lors de la création de vos solutions d'hébergement de Amazon GameLift Servers jeux et d'autres fonctionnalités. Le AWS SDK inclut ces opérations dans l'espace de aws.gamelift noms. Téléchargez le AWS SDK ou consultez la documentation de référence de l'Amazon GameLift ServersAPI. Vous pouvez également utiliser l'API avec l'interface de ligne de AWS commande (AWS CLI), comme indiqué dans la référence des AWS CLI commandes.

L'API inclut deux ensembles d'opérations pour l'hébergement géré de jeux :

L'API Amazon GameLift Servers de service contient également des opérations à utiliser avec d'autres Amazon GameLift Servers outils et solutions. Pour obtenir la liste des FleetIQ API, consultez la section Opérations FleetIQ d'API. Pour une liste des FlexMatch API pour le matchmaking, voir Opérations FlexMatch d'API.

Gérer GameLift Serveurs Amazon ressources d'hébergement

Appelez ces opérations pour configurer les ressources d'hébergement de vos serveurs de jeu, augmenter la capacité pour répondre à la demande des joueurs, obtenir des statistiques de performance et d'utilisation, etc. Utilisez ces opérations d'API lorsque vous hébergez des serveurs de jeu avecAmazon GameLift Servers, notamment Amazon GameLift ServersRealtime. Vous pouvez également travailler dans Amazon GameLift Servers la console pour la plupart des tâches de gestion des ressources ou passer des appels à l'aide de l'outil AWS Command Line Interface (AWS CLI).

Préparer les serveurs de jeu pour le déploiement

Téléchargez et configurez le code du serveur de jeu de votre jeu en vue de son déploiement et de son lancement sur les ressources d'hébergement.

Gérez les versions personnalisées des serveurs de jeu

  • upload-build — Téléchargez des fichiers de construction à partir d'un chemin local et créez une nouvelle Amazon GameLift Servers ressource de génération. Cette opération, disponible sous forme de AWS CLI commande, est la méthode la plus courante pour télécharger des versions de serveurs de jeu.

  • CreateBuild— Créez une nouvelle version à l'aide de fichiers stockés dans un compartiment Amazon S3.

  • ListBuilds— Obtenez une liste de tous les builds téléchargés Amazon GameLift Servers dans une région.

  • DescribeBuild— Récupère les informations associées à un build.

  • UpdateBuild— Modifiez les métadonnées du build, y compris le nom et la version du build.

  • DeleteBuild— Supprime une version deAmazon GameLift Servers.

Gérer les scripts Amazon GameLift Servers Realtime de configuration

  • CreateScript— Téléchargez JavaScript des fichiers et créez une nouvelle ressource de Amazon GameLift Servers script.

  • ListScripts— Obtenez une liste de tous les Realtime scripts téléchargés Amazon GameLift Servers dans une région.

  • DescribeScript— Récupère les informations associées à un Realtime script.

  • UpdateScript— Modifiez les métadonnées du script et téléchargez le contenu révisé du script.

  • DeleteScript— Supprime un Realtime script deAmazon GameLift Servers.

Configuration des ressources informatiques pour l'hébergement

Configurez les ressources d'hébergement et déployez-les avec le script de compilation ou de Realtime configuration de votre serveur de jeu.

Créez et gérez des flottes

  • CreateFleet— Configurez et déployez un nouveau Amazon GameLift Servers parc de ressources informatiques pour faire fonctionner vos serveurs de jeu. Une fois déployés, les serveurs de jeu sont automatiquement lancés tels qu'ils sont configurés et prêts à héberger des sessions de jeu.

  • ListFleets— Obtenez une liste de toutes les flottes d'une Amazon GameLift Servers région.

  • DeleteFleet— Supprimez une flotte qui ne gère plus de serveurs de jeu ou n'héberge plus de joueurs.

  • Afficher/mettre à jour les emplacements de la flotte.

  • Afficher/mettre à jour les configurations de flotte.

Gérez la capacité de la flotte

  • DescribeEC2InstanceLimits— Récupère le nombre maximum d'instances autorisées pour le AWS compte actuel et le niveau d'utilisation actuel.

  • DescribeFleetCapacity— Récupérez les paramètres de capacité actuels pour la région d'origine d'une flotte.

  • DescribeFleetLocationCapacity— Récupérez les paramètres de capacité actuels pour chaque site d'une flotte multi-sites.

  • UpdateFleetCapacity— Ajustez manuellement les paramètres de capacité d'une flotte.

  • Configuration :

    • PutScalingPolicy— Activez la mise à l'échelle automatique basée sur des cibles, créez une politique de dimensionnement automatique personnalisée ou mettez à jour une politique existante.

    • DescribeScalingPolicies— Récupérez une politique de dimensionnement automatique existante.

    • DeleteScalingPolicy— Supprimez une politique de dimensionnement automatique et empêchez-la d'affecter la capacité d'une flotte.

    • StartFleetActions— Redémarrez les politiques de dimensionnement automatique d'une flotte.

    • StopFleetActions— Suspendez les politiques de dimensionnement automatique d'une flotte.

Surveillance de l'activité de la flotte.

  • DescribeFleetUtilization— Récupérez des statistiques sur le nombre de processus du serveur, de sessions de jeu et de joueurs actuellement actifs sur une flotte.

  • DescribeFleetLocationUtilization— Récupérez les statistiques d'utilisation pour chaque site d'une flotte multisite.

  • DescribeFleetEvents— Afficher les événements enregistrés pour une flotte pendant une période spécifiée.

  • DescribeGameSessions— Récupérez les métadonnées des sessions de jeu, y compris la durée du jeu et le nombre actuel de joueurs.

Configurer des files d'attente pour le placement des sessions de jeu

Configurez des files d'attente sur plusieurs flottes et plusieurs régions pour placer des sessions de jeu avec les meilleures ressources d'hébergement disponibles en matière de coût, de latence et de résilience.

Gérer les alias

Utilisez des alias pour représenter vos flottes ou créer une destination alternative de terminal. Les alias sont utiles lors de la transition de l'activité du jeu d'une flotte à une autre, par exemple lors des mises à jour des builds du serveur de jeu.

  • CreateAlias— Définissez un nouvel alias et attribuez-le éventuellement à une flotte.

  • ListAliases— Obtenez tous les alias de flotte définis dans une Amazon GameLift Servers région.

  • DescribeAlias— Récupère les informations relatives à un alias existant.

  • UpdateAlias— Modifiez les paramètres d'un alias, par exemple en le redirigeant d'une flotte vers une autre.

  • DeleteAlias— Supprime un alias de la région.

  • ResolveAlias— Obtenez l'ID de flotte vers lequel pointe un alias spécifié.

Connectez-vous à des instances d'hébergement gérées

Affichez des informations sur les instances individuelles d'une flotte ou demandez un accès à distance à une instance de flotte spécifiée pour le dépannage.

  • DescribeInstances— Obtenez des informations sur chaque instance d'une flotte, notamment son identifiant, son adresse IP, sa localisation et son statut.

  • GetInstanceAccess— Demandez les informations d'accès nécessaires pour vous connecter à distance à une instance spécifiée d'une flotte.

Configurer l'appairage de VPC

Créez et gérez des connexions de peering VPC entre vos ressources Amazon GameLift Servers d'hébergement et d'autres AWS ressources.

Démarrez des sessions de jeu et rejoignez des joueurs

Appelez ces opérations depuis un service backend pour démarrer de nouvelles sessions de jeu, obtenir des informations sur les sessions de jeu existantes et rejoindre des joueurs à des sessions de jeu. Ces opérations sont destinées à être utilisées avec des serveurs de jeu personnalisés hébergés surAmazon GameLift Servers. Si vous l'utilisez Amazon GameLift ServersRealtime, gérez les sessions de jeu à l'aide de l'API Amazon GameLift ServersRealtime client (C#).

  • Démarrage de nouvelles sessions de jeu pour un ou plusieurs joueurs.

    • StartGameSessionPlacement— Demandez Amazon GameLift Servers à trouver les meilleures ressources d'hébergement disponibles et démarrez une nouvelle session de jeu. Il s'agit de la méthode préférée pour créer de nouvelles sessions de jeu. Il s'appuie sur les files d'attente des sessions de jeu pour suivre la disponibilité de l'hébergement dans plusieurs régions et utilise des FleetIQ algorithmes pour hiérarchiser les emplacements en fonction de la latence des joueurs, des coûts d'hébergement, de la localisation, etc.

    • DescribeGameSessionPlacement— Obtenir les détails et le statut d'une demande de placement.

    • StopGameSessionPlacement— Annuler une demande de placement.

    • CreateGameSession— Démarrez une nouvelle session de jeu vide sur un emplacement de flotte spécifique. Cette opération vous permet de mieux contrôler où commencer la session de jeu, au lieu de l'utiliser FleetIQ pour évaluer les options de placement. Vous devez ajouter des joueurs à la nouvelle session de jeu lors d'une étape distincte.

  • Invitez les joueurs à participer à des sessions de jeu existantes. Trouvez des sessions de jeu en cours avec les créneaux disponibles et réservez-les aux nouveaux joueurs.

    • CreatePlayerSession— Réservez une place libre pour qu'un joueur puisse rejoindre une session de jeu.

    • CreatePlayerSessions— Réservez des machines à sous ouvertes pour que plusieurs joueurs puissent rejoindre une session de jeu.

  • Utilisation avec des données de session de jeu et de session de joueur. Gérez les informations relatives aux sessions de jeu et aux sessions des joueurs.

    • SearchGameSessions— Demandez une liste des sessions de jeu actives en fonction d'un ensemble de critères de recherche.

    • DescribeGameSessions— Récupérez les métadonnées pour des sessions de jeu spécifiques, y compris la durée d'activité et le nombre actuel de joueurs.

    • DescribeGameSessionDetails— Récupérez les métadonnées, y compris le paramètre de protection des sessions de jeu, pour une ou plusieurs sessions de jeu.

    • DescribePlayerSessions— Obtenez des détails sur l'activité des joueurs, notamment leur statut, leur temps de jeu et leurs données.

    • UpdateGameSession— Modifiez les paramètres des sessions de jeu, tels que le nombre maximum de joueurs et la politique d'adhésion.

    • GetGameSessionLogUrl— Obtenez l'emplacement des journaux enregistrés pour une session de jeu.