View a markdown version of this page

Service-API für GameLift Amazon-Server - GameLift Amazon-Server
Verwalten Amazon-Server GameLift Hosting-RessourcenStarte Spielsitzungen und trete Spielern bei

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Service-API für GameLift Amazon-Server

Verwende diese aufgabenbasierte Liste, um nach API-Vorgängen zu suchen, wenn du deine Amazon GameLift Servers Game-Hosting-Lösungen und andere Funktionen entwickelst. Das AWS SDK beinhaltet diese Operationen im aws.gamelift Namespace. Laden Sie das AWS SDK herunter oder sehen Sie sich die Amazon GameLift Servers API-Referenzdokumentation an. Sie können die API auch mit der AWS Befehlszeilenschnittstelle (AWS CLI) verwenden, wie in der AWS CLI Befehlsreferenz dokumentiert.

Die API umfasst zwei Arten von Operationen für verwaltetes Spielhosting:

Die Amazon GameLift Servers Service-API enthält auch Operationen zur Verwendung mit anderen Amazon GameLift Servers Tools und Lösungen. Eine Liste der FleetIQ APIs finden Sie unter FleetIQ API-Operationen. Eine Liste der FlexMatch APIs für das Matchmaking finden Sie unter FlexMatch API-Operationen.

Verwalten Amazon-Server GameLift Hosting-Ressourcen

Rufen Sie diese Operationen auf, um Hosting-Ressourcen für Ihre Spieleserver zu konfigurieren, die Kapazität an die Anforderungen der Spieler anzupassen, Leistungs- und Nutzungsmetriken abzurufen und vieles mehr. Verwenden Sie diese API-Operationen, wenn Sie Spieleserver hosten mitAmazon GameLift Servers, einschließlich Amazon GameLift ServersRealtime. Für die meisten Aufgaben der Ressourcenverwaltung kannst du auch in der Amazon GameLift Servers Konsole arbeiten, oder du kannst Aufrufe mit dem Tool AWS Command Line Interface (AWS CLI) tätigen.

Bereite die Spieleserver für den Einsatz vor

Lade den Spieleservercode deines Spiels hoch und konfiguriere ihn, um die Bereitstellung und den Start auf den Hosting-Ressourcen vorzubereiten.

Verwalte benutzerdefinierte Spieleserver-Builds

  • upload-build — Laden Sie Build-Dateien von einem lokalen Pfad hoch und erstellen Sie eine neue Amazon GameLift Servers Build-Ressource. Diese Operation, die als AWS CLI Befehl verfügbar ist, ist die gängigste Methode, um Spieleserver-Builds hochzuladen.

  • CreateBuild— Erstellen Sie einen neuen Build mithilfe von Dateien, die in einem Amazon S3-Bucket gespeichert sind.

  • ListBuilds— Holen Sie sich eine Liste aller Builds, die in eine Amazon GameLift Servers Region hochgeladen wurden.

  • DescribeBuild— Ruft Informationen ab, die mit einem Build verknüpft sind.

  • UpdateBuild— Ändern Sie die Build-Metadaten, einschließlich Build-Name und Version.

  • DeleteBuild— Entfernt einen Build vonAmazon GameLift Servers.

Amazon GameLift ServersRealtimeKonfigurationsskripte verwalten

  • CreateScript— Laden Sie JavaScript Dateien hoch und erstellen Sie eine neue Amazon GameLift Servers Skriptressource.

  • ListScripts— Holen Sie sich eine Liste aller Realtime Skripte, die in eine Amazon GameLift Servers Region hochgeladen wurden.

  • DescribeScript— Ruft Informationen ab, die einem Realtime Skript zugeordnet sind.

  • UpdateScript— Ändern Sie die Skriptmetadaten und laden Sie den überarbeiteten Skriptinhalt hoch.

  • DeleteScript— Entferne ein Realtime Skript ausAmazon GameLift Servers.

Richten Sie Computerressourcen für das Hosting ein

Konfiguriere Hosting-Ressourcen und stelle sie mit deinem Gameserver-Build- oder Realtime Konfigurationsskript bereit.

Erstelle und verwalte Flotten

  • CreateFleet— Konfiguriere und setze eine neue Amazon GameLift Servers Flotte von Computerressourcen ein, um deine Spieleserver zu betreiben. Nach der Bereitstellung werden die Spieleserver automatisch wie konfiguriert gestartet und sind bereit, Spielsitzungen abzuhalten.

  • ListFleets— Holen Sie sich eine Liste aller Flotten in einer Amazon GameLift Servers Region.

  • DeleteFleet— Entferne eine Flotte, auf der keine Spielserver mehr laufen oder die keine Spieler mehr hostet.

  • Flottenstandorte anzeigen/aktualisieren.

    • CreateFleetLocations— Fügen Sie einer vorhandenen Flotte, die mehrere Standorte unterstützt, entfernte Standorte hinzu

    • DescribeFleetLocationAttributes— Holen Sie sich eine Liste aller abgelegenen Standorte einer Flotte und sehen Sie sich den aktuellen Status jedes Standorts an.

    • DeleteFleetLocations— Entferne entfernte Standorte aus einer Flotte, die mehrere Standorte unterstützt.

  • Anzeigen/Aktualisieren von Flottenkonfigurationen.

Flottenkapazität verwalten

  • DescribeEC2InstanceLimits— Ruft die maximal zulässige Anzahl von Instances für das aktuelle AWS Konto und das aktuelle Nutzungsniveau ab.

  • DescribeFleetCapacity— Ruft die aktuellen Kapazitätseinstellungen für die Heimatregion einer Flotte ab.

  • DescribeFleetLocationCapacity— Ruft die aktuellen Kapazitätseinstellungen für jeden Standort in einer Flotte mit mehreren Standorten ab.

  • UpdateFleetCapacity— Passen Sie die Kapazitätseinstellungen für eine Flotte manuell an.

  • Einrichten:

    • PutScalingPolicy— Aktivieren Sie zielbasiertes Auto Scaling, erstellen Sie eine benutzerdefinierte Auto Scaling-Richtlinie oder aktualisieren Sie eine vorhandene Richtlinie.

    • DescribeScalingPolicies— Ruft eine vorhandene Auto Scaling-Richtlinie ab.

    • DeleteScalingPolicy— Löschen Sie eine Auto-Scaling-Richtlinie und verhindern Sie, dass sie die Kapazität einer Flotte beeinträchtigt.

    • StartFleetActions— Starten Sie die Auto-Scaling-Richtlinien einer Flotte neu.

    • StopFleetActions— Setzen Sie die Auto-Scaling-Richtlinien einer Flotte aus.

Überwachen Sie die Flottenaktivität.

  • DescribeFleetUtilization— Ruft Statistiken zur Anzahl der Serverprozesse, Spielsitzungen und Spieler ab, die derzeit in einer Flotte aktiv sind.

  • DescribeFleetLocationUtilization— Ruft Nutzungsstatistiken für jeden Standort in einer Flotte mit mehreren Standorten ab.

  • DescribeFleetEvents— Zeigt protokollierte Ereignisse für eine Flotte während eines bestimmten Zeitraums an.

  • DescribeGameSessions— Ruft Metadaten zur Spielsitzung ab, einschließlich der Laufzeit eines Spiels und der aktuellen Spieleranzahl.

Richten Sie Warteschlangen für die Platzierung der Spielsitzungen ein

Richten Sie Warteschlangen für mehrere Flotten und Regionen ein, um Spielsitzungen mit den besten verfügbaren Hosting-Ressourcen für Kosten, Latenz und Ausfallsicherheit zu platzieren.

  • CreateGameSessionQueue— Erstellen Sie eine Warteschlange, die bei der Bearbeitung von Anfragen für Platzierungen von Spielsitzungen verwendet werden kann.

  • DescribeGameSessionQueues— Ruft die in einer Region definierten Warteschlangen für Spielsitzungen ab. Amazon GameLift Servers

  • UpdateGameSessionQueue— Ändert die Konfiguration einer Warteschlange für Spielsitzungen.

  • DeleteGameSessionQueue— Entferne eine Warteschlange für Spielsitzungen aus der Region.

Verwalten von Aliase

Verwenden Sie Aliase, um Ihre Flotten darzustellen oder ein zum Terminal alternatives Ziel zu erstellen. Aliase sind nützlich beim Übergang von Spielaktivitäten von einer Flotte zu einer anderen, wie z. B. bei Aktualisierungen des Spielserver-Builds.

  • CreateAlias— Definiere einen neuen Alias und weise ihn optional einer Flotte zu.

  • ListAliases— Ruft alle Flottenaliase ab, die in einer Amazon GameLift Servers Region definiert wurden.

  • DescribeAlias— Ruft Informationen zu einem vorhandenen Alias ab.

  • UpdateAlias— Ändern Sie die Einstellungen für einen Alias, z. B. indem Sie ihn von einer Flotte zur anderen umleiten.

  • DeleteAlias— Entfernt einen Alias aus der Region.

  • ResolveAlias— Ruft die Flotten-ID ab, auf die ein bestimmter Alias verweist.

Stellen Sie eine Verbindung zu verwalteten Hosting-Instanzen her

Zeigen Sie Informationen zu einzelnen Instances in einer Flotte an oder fordern Sie zur Fehlerbehebung Fernzugriff auf eine bestimmte Flotteninstance an.

  • DescribeInstances— Rufen Sie Informationen zu jeder Instanz in einer Flotte ab, einschließlich Instanz-ID, IP-Adresse, Standort und Status.

  • GetInstanceAccess— Fordern Sie die Zugangsdaten an, die für die Fernverbindung zu einer bestimmten Instance in einer Flotte erforderlich sind.

VPC-Peering einrichten

Erstellen und verwalten Sie VPC-Peering-Verbindungen zwischen Ihren Amazon GameLift Servers Hosting-Ressourcen und anderen AWS Ressourcen.

Starte Spielsitzungen und trete Spielern bei

Rufen Sie diese Operationen von einem Backend-Dienst aus auf, um neue Spielsitzungen zu starten, Informationen über bestehende Spielsitzungen abzurufen und Spieler zu Spielsitzungen hinzuzufügen. Diese Operationen sind für benutzerdefinierte Spieleserver vorgesehen, auf Amazon GameLift Servers denen gehostet wird. Wenn du verwendest Amazon GameLift ServersRealtime, verwalte Spielsitzungen mithilfe der Amazon GameLift ServersRealtime Client-API (C#).

  • Starten Sie neue Spielsitzungen für einen oder mehrere Spieler.

    • StartGameSessionPlacement— Fragen Sie Amazon GameLift Servers nach den besten verfügbaren Hosting-Ressourcen und starten Sie eine neue Spielsitzung. Dies ist die bevorzugte Methode, um neue Spielsitzungen zu erstellen. Sie stützt sich auf Warteschlangen für Spielsitzungen, um die Verfügbarkeit von Gastgebern in mehreren Regionen zu verfolgen, und verwendet FleetIQ Algorithmen, um Platzierungen auf der Grundlage der Spielerlatenz, der Hosting-Kosten, des Standorts usw. zu priorisieren.

    • DescribeGameSessionPlacement— Erhalte Informationen und den Status einer Platzierungsanfrage.

    • StopGameSessionPlacement— Stornieren Sie eine Praktikumsanfrage.

    • CreateGameSession— Starte eine neue, leere Spielsitzung an einem bestimmten Flottenstandort. Diese Operation gibt dir mehr Kontrolle darüber, wo die Spielsitzung beginnen soll, anstatt sie FleetIQ zur Bewertung der Platzierungsoptionen zu verwenden. Sie müssen in einem separaten Schritt Spieler zur neuen Spielsitzung hinzufügen.

  • Binden Sie Spieler in bestehende Spielsitzungen ein. Finde laufende Spielsitzungen mit verfügbaren Spielerplätzen und reserviere sie für neue Spieler.

    • CreatePlayerSession— Reserviere einen freien Platz, damit ein Spieler an einer Spielsitzung teilnehmen kann.

    • CreatePlayerSessions— Reservieren Sie offene Plätze für mehrere Spieler, um an einer Spielsitzung teilzunehmen.

  • Arbeiten Sie mit Spielsitzungs- und Spielersitzungsdaten. Verwalte Informationen zu Spielsitzungen und Spielersitzungen.

    • SearchGameSessions— Fordere eine Liste der aktiven Spielsitzungen auf der Grundlage einer Reihe von Suchkriterien an.

    • DescribeGameSessions— Ruft Metadaten für bestimmte Spielsitzungen ab, einschließlich der aktiven Zeit und der aktuellen Spielerzahl.

    • DescribeGameSessionDetails— Ruft Metadaten, einschließlich der Einstellung zum Schutz von Spielsitzungen, für eine oder mehrere Spielsitzungen ab.

    • DescribePlayerSessions— Erhalte Details zur Spieleraktivität, einschließlich Status, Spielzeit und Spielerdaten.

    • UpdateGameSession— Ändere die Einstellungen für die Spielsitzung, z. B. die maximale Spielerzahl und die Teilnahmebedingungen.

    • GetGameSessionLogUrl— Ruft den Speicherort der gespeicherten Protokolle für eine Spielsitzung ab.