Service-API für Amazon GameLift Servers - Amazon GameLift Servers

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 Amazon GameLift Servers

Verwenden Sie diese aufgabenbasierte Liste, um API-Operationen zu finden, wenn Sie Ihre Amazon GameLift Servers Game-Hosting-Lösungen und andere Funktionen erstellen. 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 Gruppen von Vorgängen für das verwaltete Spiele-Hosting:

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

Amazon GameLift ServersHosting-Ressourcen verwalten

Rufen Sie diese Operationen auf, um Hosting-Ressourcen für Ihre Spieleserver zu konfigurieren, die Kapazität entsprechend der Nachfrage der Spieler zu skalieren, Leistungs- und Nutzungsdaten zu erhalten und vieles mehr. Verwenden Sie diese API-Operationen beim Hosten von Spieleservern mitAmazon GameLift Servers, einschließlich Amazon GameLift ServersRealtime. Sie können für die meisten Aufgaben zur Ressourcenverwaltung auch in der Amazon GameLift ServersKonsole arbeiten oder Aufrufe mit dem Tool AWS Command Line Interface (AWS CLI) tätigen.

Bereiten Sie die Spieleserver für die Bereitstellung vor

Laden Sie den Gameservercode Ihres Spiels hoch und konfigurieren Sie ihn, um die Bereitstellung und den Start auf Hosting-Ressourcen vorzubereiten.

Verwalte benutzerdefinierte Gameserver-Builds

  • Upload-Build — Laden Sie Build-Dateien von einem lokalen Pfad hoch und erstellen Sie eine neue Amazon GameLift Servers Build-Ressource. Dieser Vorgang, der als AWS CLI Befehl verfügbar ist, ist die gängigste Methode zum Hochladen von Spielserver-Builds.

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

  • ListBuilds— Ruft eine Liste aller Builds ab, 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 des Build-Namens und der Build-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— Ruft eine Liste aller Realtime Skripte ab, die in eine Amazon GameLift Servers Region hochgeladen wurden.

  • DescribeScript— Ruft Informationen ab, die mit einem Realtime Skript verknüpft sind.

  • UpdateScript— Ändern Sie die Skript-Metadaten und laden Sie den überarbeiteten Skriptinhalt hoch.

  • DeleteScript— Entferne ein Realtime Skript vonAmazon GameLift Servers.

Richten Sie Rechenressourcen für das Hosting ein

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

Flotten erstellen und verwalten

  • CreateFleet— Konfiguriere und implementiere eine neue Amazon GameLift Servers Flotte von Computerressourcen für den Betrieb deiner Spieleserver. Nach der Bereitstellung werden die Spieleserver automatisch so gestartet, wie sie konfiguriert sind und bereit sind, Spielsitzungen abzuhalten.

  • ListFleets— Ruft eine Liste aller Flotten in einer Amazon GameLift Servers Region ab.

  • DeleteFleet— Entferne eine Flotte, die keine Spieleserver mehr betreibt oder Spieler hostet.

  • Standorte der Flotte anzeigen/aktualisieren.

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

    • DescribeFleetLocationAttributes— Rufen Sie eine Liste aller abgelegenen Standorte für eine Flotte ab 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

  • Beschreiben EC2 InstanceLimits — Ruft die maximal zulässige Anzahl von Instanzen für das aktuelle AWS Konto und die aktuelle Nutzungsstufe ab.

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

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

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

  • Einrichten von :

    • PutScalingPolicy— Aktivieren Sie die zielbasierte auto-scaling, erstellen Sie eine benutzerdefinierte auto-scaling Skalierungsrichtlinie oder aktualisieren Sie eine bestehende Richtlinie.

    • DescribeScalingPolicies— Rufen Sie eine bestehende 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 Richtlinien für die auto-scaling einer Flotte neu.

    • StopFleetActions— Setzen Sie die Richtlinien für die auto-scaling einer Flotte aus.

Überwachen Sie die Flottenaktivität.

  • DescribeFleetUtilization— Ruft Statistiken über die 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 einer Spielsitzung ab, einschließlich der Laufzeit eines Spiels und der aktuellen Spielerzahl.

Richten Sie Warteschlangen für die Platzierung von 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 wird.

  • 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— Löscht 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 sind.

  • DescribeAlias— Ruft Informationen zu einem vorhandenen Alias ab.

  • UpdateAlias— Ändern Sie die Einstellungen für einen Alias, z. B. die Umleitung von einer Flotte zu einer anderen.

  • DeleteAlias— Entferne einen Alias aus der Region.

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

Connect 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 Remoteverbindung zu einer bestimmten Instanz 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 Back-End-Dienst aus auf, um neue Spielsitzungen zu starten, Informationen über bestehende Spielsitzungen zu erhalten und Spieler zu Spielsitzungen hinzuzufügen. Diese Operationen sind für benutzerdefinierte Spieleserver vorgesehen, die auf Amazon GameLift Servers gehostet werden. Wenn Sie verwenden Amazon GameLift ServersRealtime, verwalten Sie Spielesitzungen mit demAmazon GameLift ServersRealtimeClient-API-Referenz (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 zum Erstellen neuer Spielsitzungen. Es stützt sich auf Warteschlangen für Spielsitzungen, um die Verfügbarkeit von Hostings in mehreren Regionen zu verfolgen, und verwendet FleetIQ Algorithmen, um Platzierungen auf der Grundlage von Spielerlatenz, Hosting-Kosten, Standort usw. zu priorisieren.

    • DescribeGameSessionPlacement— Informiere dich über Einzelheiten und den Status einer Platzierungsanfrage.

    • StopGameSessionPlacement— Stornieren Sie eine Platzierungsanfrage.

    • CreateGameSession— Startet eine neue, leere Spielsitzung an einem bestimmten Flottenstandort. Dieser Vorgang gibt dir mehr Kontrolle darüber, wo die Spielsitzung beginnen soll, anstatt sie FleetIQ zur Bewertung der Platzierungsoptionen zu verwenden. Sie müssen der neuen Spielsitzung in einem separaten Schritt Spieler 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 offenen Slot für einen Spieler, um an einer Spielsitzung teilzunehmen.

    • CreatePlayerSessions— Reservieren Sie offene Slots 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— Rufen Sie Metadaten für bestimmte Spielsitzungen ab, einschließlich der aktiven Zeit und der aktuellen Spielerzahl.

    • DescribeGameSessionDetails— Ruft Metadaten, einschließlich der Schutzeinstellungen für Spielsitzungen, für eine oder mehrere Spielsitzungen ab.

    • DescribePlayerSessions— Informieren Sie sich über Spieleraktivitäten, einschließlich Status, Spielzeit und Spielerdaten.

    • UpdateGameSession— Ändern Sie die Einstellungen für Spielsitzungen, z. B. die maximale Spielerzahl und die Beitrittsrichtlinien.

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