Beispiele für die Verwendung der AWS CLI mit Amazon GameLift Servers

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Amazon GameLift Servers nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt, wie create-build verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie einen Spiele-Build aus Dateien in einem S3-Bucket

Im folgenden Beispiel für create-build wird eine benutzerdefinierte Spiele-Build-Ressource erstellt. Es werden komprimierte Dateien verwendet, die an einem S3-Speicherort in einem AWS-Konto gespeichert sind, das Sie kontrollieren. In diesem Beispiel wird vorausgesetzt, dass Sie bereits eine IAM-Rolle erstellt haben, die Amazon GameLift die Berechtigung erteilt, auf den S3-Standort zuzugreifen. Da die Anfrage kein Betriebssystem spezifiziert, ist die neue Build-Ressource standardmäßig WINDOWS_2012.


aws gamelift create-build \
    --storage-location file://storage-loc.json \
    --name MegaFrogRaceServer.NA \
    --build-version 12345.678

Inhalt von storage-loc.json:


{
    "Bucket":"MegaFrogRaceServer_NA_build_files"
    "Key":"MegaFrogRaceServer_build_123.zip"
    "RoleArn":"arn:aws:iam::123456789012:role/gamelift"
}

Ausgabe:


{
    "Build": {
        "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "CreationTime": 1496708916.18,
        "Name": "MegaFrogRaceServer.NA",
        "OperatingSystem": "WINDOWS_2012",
        "SizeOnDisk": 479303,
        "Status": "INITIALIZED",
        "Version": "12345.678"
    },
    "StorageLocation": {
        "Bucket": "MegaFrogRaceServer_NA_build_files",
        "Key": "MegaFrogRaceServer_build_123.zip"
    }
}

Beispiel 2: So erstellen Sie eine Spiele-Build-Ressource für das manuelle Hochladen von Dateien auf GameLift

Im folgenden Beispiel für create-build wird eine neue Build-Ressource erstellt. Es werden auch ein Speicherort und temporäre Anmeldeinformationen zugewiesen, mit denen Sie Ihren Spiele-Build manuell an den GameLift-Speicherort in Amazon S3 hochladen können. Sobald Sie Ihren Build erfolgreich hochgeladen haben, validiert der GameLift-Service den Build und aktualisiert den Status des neuen Builds.


aws gamelift create-build \
    --name MegaFrogRaceServer.NA \
    --build-version 12345.678 \
    --operating-system AMAZON_LINUX

Ausgabe:


{
    "Build": {
        "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "CreationTime": 1496708916.18,
        "Name": "MegaFrogRaceServer.NA",
        "OperatingSystem": "AMAZON_LINUX",
        "SizeOnDisk": 0,
        "Status": "INITIALIZED",
        "Version": "12345.678"
    },
    "StorageLocation": {
        "Bucket": "gamelift-builds-us-west-2",
        "Key": "123456789012/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
    },
    "UploadCredentials": {
        "AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
        "SessionToken": "AgoGb3JpZ2luENz...EXAMPLETOKEN=="
    }
}

Weitere Informationen finden Sie unter Hochladen eines benutzerdefinierten Server-Builds auf GameLift im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter CreateBuild in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-fleet verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie eine grundlegende Linux-Flotte

Im folgenden Beispiel für create-fleet wird eine minimal konfigurierte Flotte von Linux-On-Demand-Instances erstellt, um einen benutzerdefinierten Server-Build zu hosten. Sie können die Konfiguration mit update-fleet abschließen.


aws gamelift create-fleet \
    --name MegaFrogRaceServer.NA.v2 \
    --description 'Hosts for v2 North America' \
    --build-id build-1111aaaa-22bb-33cc-44dd-5555eeee66ff \
    --certificate-configuration 'CertificateType=GENERATED' \
    --ec2-instance-type c4.large \
    --fleet-type ON_DEMAND \
    --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/release-na/MegaFrogRace_Server.exe,ConcurrentExecutions=1}]'

Ausgabe:


{
    "FleetAttributes": {
        "BuildId": "build-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        },
        "CreationTime": 1496365885.44,
        "Description": "Hosts for v2 North America",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetType": "ON_DEMAND",
        "InstanceType": "c4.large",
        "MetricGroups": ["default"],
        "Name": "MegaFrogRace.NA.v2",
        "NewGameSessionProtectionPolicy": "NoProtection",
        "OperatingSystem": "AMAZON_LINUX",
        "ServerLaunchPath": "/local/game/release-na/MegaFrogRace_Server.exe",
        "Status": "NEW"
    }
}

Beispiel 2: So erstellen Sie eine grundlegende Windows-Flotte

Im folgenden Beispiel für create-fleet wird eine minimal konfigurierte Flotte von Windows-Spot-Instances erstellt, um einen benutzerdefinierten Server-Build zu hosten. Sie können die Konfiguration mit update-fleet abschließen.


aws gamelift create-fleet \
    --name MegaFrogRace.NA.v2 \
    --description 'Hosts for v2 North America' \
    --build-id build-2222aaaa-33bb-44cc-55dd-6666eeee77ff  \
    --certificate-configuration 'CertificateType=GENERATED' \
    --ec2-instance-type c4.large \
    --fleet-type SPOT \
    --runtime-configuration 'ServerProcesses=[{LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}]'

Ausgabe:


{
    "FleetAttributes": {
        "BuildId": "build-2222aaaa-33bb-44cc-55dd-6666eeee77ff",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        },
        "CreationTime": 1496365885.44,
        "Description": "Hosts for v2 North America",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetType": "SPOT",
        "InstanceType": "c4.large",
        "MetricGroups": ["default"],
        "Name": "MegaFrogRace.NA.v2",
        "NewGameSessionProtectionPolicy": "NoProtection",
        "OperatingSystem": "WINDOWS_2012",
        "ServerLaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe",
        "Status": "NEW"
    }
}

Beispiel 3: So erstellen Sie eine vollständig konfigurierte Flotte

Im folgenden Beispiel für create-fleet wird eine Flotte von Windows-Spot-Instances für einen benutzerdefinierten Server-Build erstellt, wobei die am häufigsten verwendeten Konfigurationseinstellungen bereitgestellt werden.


aws gamelift create-fleet \
    --name MegaFrogRace.NA.v2 \
    --description 'Hosts for v2 North America' \
    --build-id build-2222aaaa-33bb-44cc-55dd-6666eeee77ff \
    --certificate-configuration 'CertificateType=GENERATED' \
    --ec2-instance-type c4.large \
    --ec2-inbound-permissions 'FromPort=33435,ToPort=33435,IpRange=10.24.34.0/23,Protocol=UDP' \
    --fleet-type SPOT \
    --new-game-session-protection-policy FullProtection \
    --runtime-configuration file://runtime-config.json \
    --metric-groups default \
    --instance-role-arn 'arn:aws:iam::444455556666:role/GameLiftS3Access'

Inhalt von runtime-config.json:


GameSessionActivationTimeoutSeconds=300,
 MaxConcurrentGameSessionActivations=2,
 ServerProcesses=[
   {LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,Parameters=-debug,ConcurrentExecutions=1},
   {LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}]

Ausgabe:


{
    "FleetAttributes": {
        "InstanceRoleArn": "arn:aws:iam::444455556666:role/GameLiftS3Access",
        "Status": "NEW",
        "InstanceType": "c4.large",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "Description": "Hosts for v2 North America",
        "FleetType": "SPOT",
        "OperatingSystem": "WINDOWS_2012",
        "Name": "MegaFrogRace.NA.v2",
        "CreationTime": 1569309011.11,
        "MetricGroups": [
            "default"
        ],
        "BuildId": "build-2222aaaa-33bb-44cc-55dd-6666eeee77ff",
        "ServerLaunchParameters": "abc",
        "ServerLaunchPath": "C:\\game\\Bin64.Release.Dedicated\\MegaFrogRace_Server.exe",
        "NewGameSessionProtectionPolicy": "FullProtection",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        }
    }
}

Beispiel 4: So erstellen Sie eine Realtime-Server-Flotte

Im folgenden Beispiel für create-fleet wird eine Flotte von Spot Instances mit einem Realtime-Konfigurationsskript erstellt, das auf Amazon GameLift hochgeladen wurde. Alle Realtime-Server werden auf Linux-Computern bereitgestellt. Gehen Sie für dieses Beispiel davon aus, dass das hochgeladene Realtime-Skript mehrere Skriptdateien enthält, wobei sich die Init()-Funktion in der Skriptdatei namens MainScript.js befindet. Wie gezeigt, wird diese Datei in der Laufzeitkonfiguration als Startskript identifiziert.


aws gamelift create-fleet \
    --name MegaFrogRace.NA.realtime \
    --description 'Mega Frog Race Realtime fleet' \
    --script-id script-1111aaaa-22bb-33cc-44dd-5555eeee66ff \
    --ec2-instance-type c4.large \
    --fleet-type SPOT \
    --certificate-configuration 'CertificateType=GENERATED' --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/MainScript.js,Parameters=+map Winter444,ConcurrentExecutions=5}]'

Ausgabe:


{
    "FleetAttributes": {
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "Status": "NEW",
        "CreationTime": 1569310745.212,
        "InstanceType": "c4.large",
        "NewGameSessionProtectionPolicy": "NoProtection",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        },
        "Name": "MegaFrogRace.NA.realtime",
        "ScriptId": "script-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetType": "SPOT",
        "MetricGroups": [
            "default"
        ],
        "Description": "Mega Frog Race Realtime fleet",
        "OperatingSystem": "AMAZON_LINUX"
    }
}

API-Details finden Sie unter CreateFleet in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-game-session-queue verwendet wird.

AWS CLI

Beispiel 1: So richten Sie eine geordnete Warteschlange für Spielsitzungen ein

Im folgenden Beispiel für create-game-session-queue wird eine neue Warteschlange für Spielsitzungen mit Zielen in zwei Regionen erstellt. Außerdem wird die Warteschlange so konfiguriert, dass Spielsitzungsanfragen nach 10 Minuten Wartezeit auf die Platzierung ablaufen. Da keine Latenzrichtlinien definiert sind, versucht GameLift, alle Spielsitzungen beim zuerst aufgeführten Ziel zu platzieren.


aws gamelift create-game-session-queue \
    --name MegaFrogRaceServer-NA \
    --destinations file://destinations.json \
    --timeout-in-seconds 600

Inhalt von destinations.json:


{
    "Destinations": [
        {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" },
        {"DestinationArn": "arn:aws:gamelift:us-west-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" }
    ]
}

Ausgabe:


{
    "GameSessionQueues": [
        {
            "Name": "MegaFrogRaceServer-NA",
            "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRaceServer-NA",
            "TimeoutInSeconds": 600,
            "Destinations": [
                {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"},
                {"DestinationArn": "arn:aws:gamelift:us-west-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}
            ]
        }
    ]
}

Beispiel 2: So richten Sie eine Warteschlange für Spielsitzungen mit Latenzrichtlinien für Spieler ein

Im folgenden Beispiel für create-game-session-queue wird eine neue Warteschlange für Spielsitzungen mit zwei Latenzrichtlinien für Spieler erstellt. Die erste Richtlinie legt eine Latenzgrenze von 100 ms fest, die während der ersten Minute eines Platzierungsversuchs für eine Spielsitzung durchgesetzt wird. Die zweite Richtlinie erhöht die Latenzgrenze auf 200 ms, bis die Platzierungsanfrage nach 3 Minuten abläuft.


aws gamelift create-game-session-queue \
    --name MegaFrogRaceServer-NA \
    --destinations file://destinations.json \
    --player-latency-policies file://latency-policies.json \
    --timeout-in-seconds 180

Inhalt von destinations.json:


{
    "Destinations": [
        { "DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" },
        { "DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" }
    ]
}

Inhalt von latency-policies.json:


{
    "PlayerLatencyPolicies": [
        {"MaximumIndividualPlayerLatencyMilliseconds": 200},
        {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60}
    ]
}

Ausgabe:


{
    "GameSessionQueue": {
        "Name": "MegaFrogRaceServer-NA",
        "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:111122223333:gamesessionqueue/MegaFrogRaceServer-NA",
        "TimeoutInSeconds": 600,
        "PlayerLatencyPolicies": [
            {
                "MaximumIndividualPlayerLatencyMilliseconds": 100,
                "PolicyDurationSeconds": 60
            },
            {
                "MaximumIndividualPlayerLatencyMilliseconds": 200
            }
        ]
        "Destinations": [
            {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"},
            {"DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}
        ],
    }
}

Weitere Informationen finden Sie unter Erstellen einer Warteschlange im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter CreateGameSessionQueue in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-build verwendet wird.

AWS CLI

So löschen Sie einen benutzerdefinierten Spiele-Build

Im folgenden Beispiel für delete-build wird ein Build aus Ihrem Amazon-GameLift-Konto entfernt. Nachdem der Build gelöscht wurde, können Sie ihn nicht mehr zum Erstellen neuer Flotten verwenden. Diese Operation kann nicht rückgängig gemacht werden.


aws gamelift delete-build \
   --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

API-Details finden Sie unter DeleteBuild in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-fleet verwendet wird.

AWS CLI

So löschen Sie eine Flotte, die nicht mehr verwendet wird

Im folgenden Beispiel für delete-fleet wird eine Flotte entfernt, die auf null Instances herunterskaliert wurde. Wenn die Flottenkapazität größer als Null ist, schlägt die Anfrage mit einem HTTP-400-Fehler fehl.


aws gamelift delete-fleet \
   --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwalten von GameLift-Flotten im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DeleteFleet in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-game-session-queue verwendet wird.

AWS CLI

So löschen Sie eine Warteschlange für Spielsitzungen

Im folgenden Beispiel für delete-game-session-queue wird eine angegebene Warteschlange für Spielsitzungen gelöscht.


aws gamelift delete-game-session-queue \
    --name MegaFrogRace-NA

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

API-Details finden Sie unter DeleteGameSessionQueue in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-build verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem benutzerdefinierten Spiele-Build ab

Im folgenden Beispiel für describe-build werden Eigenschaften für eine Spieleserver-Build-Ressource abgerufen.


aws gamelift describe-build \
    --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Ausgabe:


{
    "Build": {
        "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "CreationTime": 1496708916.18,
        "Name": "My_Game_Server_Build_One",
        "OperatingSystem": "AMAZON_LINUX",
        "SizeOnDisk": 1304924,
        "Status": "READY",
        "Version": "12345.678"
    }
}

Weitere Informationen finden Sie unter Hochladen eines benutzerdefinierten Server-Builds auf GameLift im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeBuild in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-ec2-instance-limits verwendet wird.

AWS CLI

So rufen Sie Servicelimits für einen EC2-Instance-Typ ab

Im folgenden Beispiel für describe-ec2-instance-limits werden die maximal zulässigen Instances und die aktuell verwendeten Instances für den angegebenen EC2-Instance-Typ in der aktuellen Region angezeigt. Das Ergebnis zeigt, dass nur fünf der zwanzig zulässigen Instances verwendet werden.


aws gamelift describe-ec2-instance-limits \
    --ec2-instance-type m5.large

Ausgabe:


{
    "EC2InstanceLimits": [
        {
            "EC2InstanceType": ""m5.large",
            "CurrentInstances": 5,
            "InstanceLimit": 20
        }
    ]
}

Weitere Informationen finden Sie unter Auswählen von Rechenressourcen im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeEc2InstanceLimits in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-fleet-attributes verwendet wird.

AWS CLI

Beispiel 1: So zeigen Sie Attribute für eine Liste von Flotten an

Im folgenden Beispiel für describe-fleet-attributes werden Flottenattribute für zwei angegebene Flotten abgerufen. Wie gezeigt, werden die angeforderten Flotten mit demselben Build bereitgestellt, eine für On-Demand-Instances und eine für Spot Instances, mit einigen geringfügigen Konfigurationsunterschieden.


aws gamelift describe-fleet-attributes \
    --fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222

Ausgabe:


{
    "FleetAttributes": [
        {
            "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "FleetType": "ON_DEMAND",
            "InstanceType": "c4.large",
            "Description": "On-demand hosts for v2 North America",
            "Name": "MegaFrogRaceServer.NA.v2-od",
            "CreationTime": 1568836191.995,
            "Status": "ACTIVE",
            "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "ServerLaunchPath": "C:\\game\\MegaFrogRace_Server.exe",
            "ServerLaunchParameters": "+gamelift_start_server",
            "NewGameSessionProtectionPolicy": "NoProtection",
            "OperatingSystem": "WINDOWS_2012",
            "MetricGroups": [
                "default"
            ],
            "CertificateConfiguration": {
                "CertificateType": "DISABLED"
            }
        },
        {
            "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "FleetType": "SPOT",
            "InstanceType": "c4.large",
            "Description": "On-demand hosts for v2 North America",
            "Name": "MegaFrogRaceServer.NA.v2-spot",
            "CreationTime": 1568838275.379,
            "Status": "ACTIVATING",
            "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "ServerLaunchPath": "C:\\game\\MegaFrogRace_Server.exe",
            "NewGameSessionProtectionPolicy": "NoProtection",
            "OperatingSystem": "WINDOWS_2012",
                "MetricGroups": [
                "default"
            ],
            "CertificateConfiguration": {
                "CertificateType": "GENERATED"
            }
        }
    ]
}

Beispiel 2: So fordern Sie Attribute für alle Flotten an

Im folgenden Beispiel für describe-fleet-attributes werden Flottenattribute für alle Flotten mit beliebigem Status zurückgegeben. Dieses Beispiel veranschaulicht die Verwendung von Paginierungsparametern, um jeweils eine Flotte zurückzugeben.


aws gamelift describe-fleet-attributes \
    --limit 1

Ausgabe:


{
    "FleetAttributes": [
        {
            "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "FleetArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "FleetType": "SPOT",
            "InstanceType": "c4.large",
            "Description": "On-demand hosts for v2 North America",
            "Name": "MegaFrogRaceServer.NA.v2-spot",
            "CreationTime": 1568838275.379,
            "Status": "ACTIVATING",
            "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "ServerLaunchPath": "C:\\game\\MegaFrogRace_Server.exe",
            "NewGameSessionProtectionPolicy": "NoProtection",
            "OperatingSystem": "WINDOWS_2012",
            "MetricGroups": [
                "default"
            ],
            "CertificateConfiguration": {
                "CertificateType": "GENERATED"
            }
        }
    ],
    "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2"
}

Die Ausgabe enthält einen NextToken-Wert, den Sie verwenden können, wenn Sie den Befehl ein zweites Mal aufrufen. Übergeben Sie den Wert an den --next-token-Parameter, um anzugeben, wo die Ausgabe abgerufen werden soll. Mit dem folgenden Befehl wird das zweite Ergebnis in der Ausgabe zurückgegeben.


aws gamelift describe-fleet-attributes \
    --limit 1 \
    --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1

Wiederholen Sie den Vorgang, bis die Antwort keinen NextToken-Wert umfasst.

Weitere Informationen finden Sie unter Einrichten von GameLift-Flotten im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeFleetAttributes in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-fleet-capacity verwendet wird.

AWS CLI

So zeigen Sie den Kapazitätsstatus für eine Liste von Flotten an

Im folgenden Beispiel für describe-fleet-capacity wird die aktuelle Kapazität für zwei angegebene Flotten abgerufen.


aws gamelift describe-fleet-capacity \
    --fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222

Ausgabe:


{
    "FleetCapacity": [
        {
            "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "InstanceType": "c5.large",
            "InstanceCounts": {
                "DESIRED": 10,
                "MINIMUM": 1,
                "MAXIMUM": 20,
                "PENDING": 0,
                "ACTIVE": 10,
                "IDLE": 3,
                "TERMINATING": 0
            }
        },
        {
            "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "InstanceType": "c5.large",
            "InstanceCounts": {
                "DESIRED": 13,
                "MINIMUM": 1,
                "MAXIMUM": 20,
                "PENDING": 0,
                "ACTIVE": 15,
                "IDLE": 2,
                "TERMINATING": 2
            }
        }

    ]
}

Weitere Informationen finden Sie unter GameLift-Metriken für Flotten im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeFleetCapacity in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-fleet-events verwendet wird.

AWS CLI

So fordern Sie Ereignisse für einen bestimmten Zeitraum an

Im folgenden Beispiel für describe-fleet-events werden Details zu allen flottenbezogenen Ereignissen angezeigt, die während des angegebenen Zeitraums aufgetreten sind.


aws gamelift describe-fleet-events \
    --fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --start-time 1579647600 \
    --end-time 1579649400 \
    --limit 5

Ausgabe:


{
    "Events": [
        {
            "EventId": "a37b6892-5d07-4d3b-8b47-80244ecf66b9",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_ACTIVE",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to ACTIVE",
            "EventTime": 1579649342.191
        },
        {
            "EventId": "67da4ec9-92a3-4d95-886a-5d6772c24063",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_ACTIVATING",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to ACTIVATING",
            "EventTime": 1579649321.427
        },
        {
            "EventId": "23813a46-a9e6-4a53-8847-f12e6a8381ac",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_BUILDING",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to BUILDING",
            "EventTime": 1579649321.243
        },
        {
            "EventId": "3bf217d0-1d44-42f9-9202-433ed475d2e8",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_STATE_VALIDATING",
            "Message": "Fleet fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 changed state to VALIDATING",
            "EventTime": 1579649197.449
        },
        {
            "EventId": "2ecd0130-5986-44eb-99a7-62df27741084",
            "ResourceId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "EventCode": "FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND",
            "Message": "Failed to find a valid path",
            "EventTime": 1569319075.839,
            "PreSignedLogUrl": "https://gamelift-event-logs-prod-us-west-2.s3.us-west-2.amazonaws.com/logs/fleet-83422059-8329-42a2-a4d6-c4444386a6f8/events/2ecd0130-5986-44eb-99a7-62df27741084/FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND.txt?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEB8aCXVzLXdlc3QtMiJHMEUCIHV5K%2FLPx8h310D%2FAvx0%2FZxsDy5XA3cJOwPdu3T0eBa%2FAiEA1yovokcZYy%2FV4CWW6l26aFyiSHO%2Bxz%2FBMAhEHYHMQNcqkQMImP%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgw3NDEwNjE1OTIxNzEiDI8rsZtzLzlwEDQhXSrlAtl5Ae%2Fgo6FCIzqXPbXfBOnSvFYqeDlriZarEpKqKrUt8mXQv9iqHResqCph9AKo49lwgSYTT2QoSxnrD7%2FUgv%2BZm2pVuczvuKtUA0fcx6s0GxpjIAzdIE%2F5P%2FB7B9M%2BVZ%2F9KF82hbJi0HTE6Y7BjKsEgFCvk4UXILhfjtan9iQl8%2F21ZTurAcJbm7Y5tuLF9SWSK3%2BEa7VXOcCK4D4O1sMjmdRm0q0CKZ%2FIaXoHkNvg0RVTa0hIqdvpaDQlsSBNdqTXbjHTu6fETE9Y9Ky%2BiJK5KiUG%2F59GjCpDcvS1FqKeLUEmKT7wysGmvjMc2n%2Fr%2F9VxQfte7w9srXwlLAQuwhiXAAyI5ICMZ5JvzjzQwTqD4CHTVKUUDwL%2BRZzbuuqkJObZml02CkRGp%2B74RTAzLbWptVqZTIfzctiCTmWxb%2FmKyELRYsVLrwNJ%2BGJ7%2BCrN0RC%2FjlgfLYIZyeAqjPgAu5HjgX%2BM7jCo9M7wBTrnAXKOFQuf9dvA84SuwXOJFp17LYGjrHMKv0qC3GfbTMrZ6kzeNV9awKCpXB2Gnx9z2KvIlJdqirWVpvHVGwKCmJBCesDzjJHrae3neogI1uW%2F9C6%2B4jIZPME3jXmZcEHqqw5uvAVF7aeIavtUZU8pxpDIWT0YE4p3Kriy2AA7ziCRKtVfjV839InyLk8LUjsioWK2qlpg2HXKFLpAXw1QsQyxYmFMB9sGKOUlbL7Jdkk%2BYUq8%2FDTlLxqj1S%2FiO4TI0Wo7ilAo%2FKKWWF4guuNDexj8EOOynSp1yImB%2BZf2Fua3O44W4eEXAMPLE33333&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170621T231808Z&X-Amz-SignedHeaders=host&X-Amz-Expires=900&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20170621%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
        }
    ],
    "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2"
}

Weitere Informationen finden Sie unter Debuggen von GameLift-Flottenproblemen im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeFleetEvents in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-fleet-port-settings verwendet wird.

AWS CLI

So zeigen Sie eingehende Verbindungsberechtigungen für eine Flotte an

Im folgenden Beispiel für describe-fleet-port-settings werden Verbindungseinstellungen für eine angegebene Flotte abgerufen.


aws gamelift describe-fleet-port-settings \
    --fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Ausgabe:


{
    "InboundPermissions": [
        {
            "FromPort": 33400,
            "ToPort": 33500,
            "IpRange": "0.0.0.0/0",
            "Protocol": "UDP"
        },
        {
            "FromPort": 1900,
            "ToPort": 2000,
            "IpRange": "0.0.0.0/0",
            "Protocol": "TCP"
        }
    ]
}

Weitere Informationen finden Sie unter Einrichten von GameLift-Flotten im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeFleetPortSettings in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-fleet-utilization verwendet wird.

AWS CLI

Beispiel 1: So zeigen Sie Nutzungsdaten für eine Liste von Flotten an

Im folgenden Beispiel für describe-fleet-utilization werden aktuelle Nutzungsinformationen für eine angegebene Flotte abgerufen.


aws gamelift describe-fleet-utilization \
    --fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Ausgabe:


{
    "FleetUtilization": [
        {
        "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "ActiveServerProcessCount": 100,
        "ActiveGameSessionCount": 62,
        "CurrentPlayerSessionCount": 329,
        "MaximumPlayerSessionCount": 1000
        }
    ]
}

Beispiel 2: So fordern Sie Nutzungsdaten für alle Flotten an

Im folgenden Beispiel für describe-fleet-utilization werden Flottennutzungsdaten für alle Flotten mit beliebigem Status zurückgegeben. In diesem Beispiel werden Paginierungsparameter verwendet, um jeweils Daten für zwei Flotten zurückzugeben.


aws gamelift describe-fleet-utilization \
    --limit 2

Ausgabe:


{
    "FleetUtilization": [
        {
            "FleetId": "fleet-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
            "ActiveServerProcessCount": 100,
            "ActiveGameSessionCount": 13,
            "CurrentPlayerSessionCount": 98,
            "MaximumPlayerSessionCount": 1000
        },
        {
            "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
            "ActiveServerProcessCount": 100,
            "ActiveGameSessionCount": 62,
            "CurrentPlayerSessionCount": 329,
            "MaximumPlayerSessionCount": 1000
        }
    ],
    "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2"
}

Rufen Sie den Befehl ein zweites Mal auf und übergeben Sie den NextToken-Wert als Argument an den --next-token-Parameter, um die nächsten beiden Ergebnisse anzuzeigen.


aws gamelift describe-fleet-utilization \
    --limit 2 \
    --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2

Wiederholen Sie den Vorgang, bis die Antwort keinen NextToken-Wert mehr in der Ausgabe enthält.

Weitere Informationen finden Sie unter GameLift-Metriken für Flotten im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeFleetUtilization in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-game-session-queues verwendet wird.

AWS CLI

So zeigen Sie Warteschlangen für Spielsitzungen an

Im folgenden Beispiel für describe-game-session-queues werden Eigenschaften für zwei angegebene Warteschlangen abgerufen.


aws gamelift describe-game-session-queues \
    --names MegaFrogRace-NA MegaFrogRace-EU

Ausgabe:


{
    "GameSessionQueues": [{
            "Destinations": [{
                    "DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
                },
                {
                    "DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
                }
            ],
            "Name": "MegaFrogRace-NA",
            "TimeoutInSeconds": 600,
            "GameSessionQueueArn": "arn:aws:gamelift:us-west-2::gamesessionqueue/MegaFrogRace-NA",
            "PlayerLatencyPolicies": [{
                    "MaximumIndividualPlayerLatencyMilliseconds": 200
                },
                {
                    "MaximumIndividualPlayerLatencyMilliseconds": 100,
                    "PolicyDurationSeconds": 60
                }
            ],
            "FilterConfiguration": {
                "AllowedLocations": ["us-west-2", "ap-south-1", "us-east-1"]
            },
            "PriorityConfiguration": {
                "PriorityOrder": ["LOCATION", "FLEET_TYPE", "DESTINATION"],
                "LocationOrder": ["us-west-2", "ap-south-1", "us-east-1"]
            }
        },
        {
            "Destinations": [{
                "DestinationArn": "arn:aws:gamelift:eu-west-3::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
            }],
            "Name": "MegaFrogRace-EU",
            "TimeoutInSeconds": 600,
            "GameSessionQueueArn": "arn:aws:gamelift:us-west-2::gamesessionqueue/MegaFrogRace-EU"
        }
    ]
}

Weitere Informationen finden Sie unter Verwenden multiregionaler Warteschlangen im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeGameSessionQueues in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-runtime-configuration verwendet wird.

AWS CLI

So fordern Sie die Laufzeitkonfiguration für eine Flotte ab

Im folgenden Beispiel für describe-runtime-configuration werden Details zur aktuellen Laufzeitkonfiguration für eine angegebene Flotte abgerufen.


aws gamelift describe-runtime-configuration \
    --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Ausgabe:


{
    "RuntimeConfiguration": {
        "ServerProcesses": [
            {
                "LaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe",
                "Parameters": "+gamelift_start_server",
                "ConcurrentExecutions": 3
            },
            {
                "LaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe",
                "Parameters": "+gamelift_start_server +debug",
                "ConcurrentExecutions": 1
            }
        ],
        "MaxConcurrentGameSessionActivations": 2147483647,
        "GameSessionActivationTimeoutSeconds": 300
    }
}

Weitere Informationen finden Sie unter Ausführen mehrerer Prozesse in einer Flotte im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter DescribeRuntimeConfiguration in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-builds verwendet wird.

AWS CLI

Beispiel 1: So rufen Sie eine Liste benutzerdefinierter Spiele-Builds ab

Im folgenden Beispiel für list-builds werden Eigenschaften für alle Spieleserver-Builds in der aktuellen Region abgerufen. Die Beispielanfrage veranschaulicht, wie die Paginierungsparameter Limit und NextToken verwendet werden, um die Ergebnisse in sequentiellen Sätzen abzurufen. Mit dem ersten Befehl werden die ersten beiden Builds abgerufen. Da mehr als zwei verfügbar sind, enthält die Antwort ein NextToken, um anzuzeigen, dass mehr Ergebnisse verfügbar sind.


aws gamelift list-builds \
    --limit 2

Ausgabe:


{
    "Builds": [
        {
            "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "CreationTime": 1495664528.723,
            "Name": "My_Game_Server_Build_One",
            "OperatingSystem": "WINDOWS_2012",
            "SizeOnDisk": 8567781,
            "Status": "READY",
            "Version": "12345.678"
        },
        {
            "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "CreationTime": 1495528748.555,
            "Name": "My_Game_Server_Build_Two",
            "OperatingSystem": "AMAZON_LINUX_2",
            "SizeOnDisk": 8567781,
            "Status": "FAILED",
            "Version": "23456.789"
        }
    ],
    "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE="
}

Anschließend kann der Befehl mit dem --next-token-Parameter wie folgt erneut aufgerufen werden, um die nächsten beiden Builds anzuzeigen.


aws gamelift list-builds \
    --limit 2
    --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=

Wiederholen Sie den Vorgang, bis die Antwort keinen NextToken-Wert umfasst.

Beispiel 2: So rufen Sie eine Liste benutzerdefinierter Spiele-Builds im Fehlerstatus ab

Im folgenden Beispiel für list-builds werden Eigenschaften für alle Spieleserver-Builds in der aktuellen Region abgerufen, die derzeit den Status FAILED aufweisen.


aws gamelift list-builds \
    --status FAILED

Ausgabe:


{
    "Builds": [
        {
            "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "CreationTime": 1495528748.555,
            "Name": "My_Game_Server_Build_Two",
            "OperatingSystem": "AMAZON_LINUX_2",
            "SizeOnDisk": 8567781,
            "Status": "FAILED",
            "Version": "23456.789"
        }
    ]
}

API-Details finden Sie unter ListBuilds in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-fleets verwendet wird.

AWS CLI

Beispiel 1: So rufen Sie eine Liste aller Flotten in einer Region ab

Im folgenden Beispiel für list-fleets werden die Flotten-IDs aller Flotten in der aktuellen Region angezeigt. In diesem Beispiel werden Paginierungsparameter verwendet, um jeweils zwei Flotten-IDs abzurufen. Die Antwort umfasst ein next-token-Attribut, das angibt, dass weitere Ergebnisse abgerufen werden können.


aws gamelift list-fleets \
    --limit 2

Ausgabe:


{
    "FleetIds": [
        "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
    ],
    "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE="
}

Sie können den NextToken-Wert aus der vorherigen Antwort im nächsten Befehl übergeben, wie hier gezeigt, um die nächsten beiden Ergebnisse abzurufen.


aws gamelift list-fleets \
    --limit 2 \
    --next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=

Beispiel 2: So rufen Sie eine Liste aller Flotten in einer Region mit einem bestimmten Build oder Skript ab

Im folgenden Beispiel für list-builds werden die IDs von Flotten abgerufen, die mit dem angegebenen Spiele-Build bereitgestellt wurden. Wenn Sie mit Realtime-Servern arbeiten, können Sie anstelle einer Build-ID eine Skript-ID angeben. Da in diesem Beispiel der Grenzparameter nicht angegeben ist, können die Ergebnisse bis zu 16 Flotten-IDs enthalten.


aws gamelift list-fleets \
    --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Ausgabe:


{
    "FleetIds": [
        "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
        "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444"
    ]
}

API-Details finden Sie unter ListFleets in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie request-upload-credentials verwendet wird.

AWS CLI

So aktualisieren Sie Anmeldeinformationen für das Hochladen eines Builds

Im folgenden Beispiel für create-build werden neue, gültige Anmeldeinformationen für das Hochladen einer GameLift-Build-Datei an einen Amazon-S3-Speicherort abgerufen. Anmeldeinformationen haben eine begrenzte Nutzungsdauer. Sie erhalten die Build-ID aus der Antwort auf die ursprüngliche CreateBuild-Anfrage.


aws gamelift request-upload-credentials \
    --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Ausgabe:


{
    "StorageLocation": {
        "Bucket": "gamelift-builds-us-west-2",
        "Key": "123456789012/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
    },
    "UploadCredentials": {
        "AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
        "SessionToken": "AgoGb3JpZ2luENz...EXAMPLETOKEN=="
    }
}

Weitere Informationen finden Sie unter Hochladen eines benutzerdefinierten Server-Builds auf GameLift im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter RequestUploadCredentials in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie start-fleet-actions verwendet wird.

AWS CLI

So starten Sie die Aktivität zur automatischen Skalierung der Flotte neu

Im folgenden Beispiel für start-fleet-actions wird die Verwendung aller Skalierungsrichtlinien fortgesetzt, die für die angegebene Flotte definiert sind, aber durch den Aufruf von ``stop-fleet-actions`` gestoppt wurden. Nach dem Start beginnen die Skalierungsrichtlinien sofort mit der Erfassung ihrer jeweiligen Metriken.


aws gamelift start-fleet-actions \
    --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --actions AUTO_SCALING

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

API-Details finden Sie unter StartFleetActions in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie stop-fleet-actions verwendet wird.

AWS CLI

So stoppen Sie die Aktivität zur automatischen Skalierung einer Flotte

Im folgenden Beispiel für stop-fleet-actions wird die Verwendung aller Skalierungsrichtlinien gestoppt, die für die angegebene Flotte definiert sind. Nachdem die Richtlinien ausgesetzt wurden, bleibt die Flottenkapazität auf der aktuellen Anzahl aktiver Instances bestehen, sofern sie nicht manuell angepasst wird.


aws gamelift start-fleet-actions \
    --fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --actions AUTO_SCALING

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

API-Details finden Sie unter StopFleetActions in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-build verwendet wird.

AWS CLI

So aktualisieren Sie einen benutzerdefinierten Spiele-Build

Im folgenden Beispiel für update-build werden der Name und die Versionsinformationen geändert, die einer angegebenen Build-Ressource zugeordnet sind. Das zurückgegebene Build-Objekt bestätigt, dass die Änderungen erfolgreich vorgenommen wurden.


aws gamelift update-build \
    --build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --name MegaFrogRaceServer.NA.east \
    --build-version 12345.east

Ausgabe:


{
    "Build": {
        "BuildArn": "arn:aws:gamelift:us-west-2::build/build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "BuildId": "build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "CreationTime": 1496708916.18,
        "Name": "MegaFrogRaceServer.NA.east",
        "OperatingSystem": "AMAZON_LINUX_2",
        "SizeOnDisk": 1304924,
        "Status": "READY",
        "Version": "12345.east"
    }
}

Weitere Informationen finden Sie unter Aktualisieren Ihrer Build-Dateien im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter UpdateBuild in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-game-session-queue verwendet wird.

AWS CLI

So aktualisieren Sie die Konfiguration einer Warteschlange für Spielsitzungen

Im folgenden Beispiel für update-game-session-queue wird ein neues Ziel hinzugefügt und die Spielerlatenz-Richtlinien werden für eine bestehende Spielsitzungswarteschlange aktualisiert.


aws gamelift update-game-session-queue \
    --name MegaFrogRace-NA \
    --destinations file://destinations.json \
    --player-latency-policies file://latency-policies.json

Inhalt von destinations.json:


{
    "Destinations": [
        {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"},
        {"DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-5c6d3c4d-5e6f-7a8b-9c0d-1e2f3a4b5a2b"},
        {"DestinationArn": "arn:aws:gamelift:us-east-1::alias/alias-11aa22bb-3c4d-5e6f-000a-1111aaaa22bb"}
    ]
}

Inhalt von latency-policies.json:


{
    "PlayerLatencyPolicies": [
        {"MaximumIndividualPlayerLatencyMilliseconds": 200},
        {"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120},
        {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120}
    ]
}

Ausgabe:


{
    "GameSessionQueue": {
        "Destinations": [
            {"DestinationArn": "arn:aws:gamelift:us-west-2::fleet/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"},
            {"DestinationArn": "arn:aws:gamelift:us-east-1::fleet/fleet-5c6d3c4d-5e6f-7a8b-9c0d-1e2f3a4b5a2b"},
            {"DestinationArn": "arn:aws:gamelift:us-east-1::alias/alias-11aa22bb-3c4d-5e6f-000a-1111aaaa22bb"}
        ],
        "GameSessionQueueArn": "arn:aws:gamelift:us-west-2:111122223333:gamesessionqueue/MegaFrogRace-NA",
        "Name": "MegaFrogRace-NA",
        "TimeoutInSeconds": 600,
        "PlayerLatencyPolicies": [
            {"MaximumIndividualPlayerLatencyMilliseconds": 200},
            {"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120},
            {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120}
        ]
    }
}

Weitere Informationen finden Sie unter Verwenden multiregionaler Warteschlangen im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter UpdateGameSessionQueue in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie upload-build verwendet wird.

AWS CLI

Beispiel 1: So laden Sie einen Linux-Spieleserver-Build hoch

Im folgenden Beispiel für upload-build werden Linux-Spieleserver-Build-Dateien aus einem Dateiverzeichnis in den GameLift-Service hochgeladen und eine Build-Ressource erstellt.


aws gamelift upload-build \
    --name MegaFrogRaceServer.NA \
    --build-version 2.0.1 \
    --build-root ~/MegaFrogRace_Server/release-na \
    --operating-system AMAZON_LINUX_2
    --server-sdk-version 4.0.2

Ausgabe:


Uploading ~/MegaFrogRace_Server/release-na:  16.0 KiB / 74.6 KiB (21.45%)
Uploading ~/MegaFrogRace_Server/release-na:  32.0 KiB / 74.6 KiB (42.89%)
Uploading ~/MegaFrogRace_Server/release-na:  48.0 KiB / 74.6 KiB (64.34%)
Uploading ~/MegaFrogRace_Server/release-na:  64.0 KiB / 74.6 KiB (85.79%)
Uploading ~/MegaFrogRace_Server/release-na:  74.6 KiB / 74.6 KiB (100.00%)
Successfully uploaded ~/MegaFrogRace_Server/release-na to AWS GameLift
Build ID: build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Beispiel 2: So laden Sie einen Windows-Spieleserver-Build hoch

Im folgenden Beispiel für upload-build werden Windows-Spieleserver-Build-Dateien aus einem Verzeichnis in den GameLift-Service hochgeladen und ein Build-Datensatz erstellt.


aws gamelift upload-build \
    --name MegaFrogRaceServer.NA \
    --build-version 2.0.1 \
    --build-root C:\MegaFrogRace_Server\release-na \
    --operating-system WINDOWS_2012
    --server-sdk-version 4.0.2

Ausgabe:


Uploading C:\MegaFrogRace_Server\release-na:  16.0 KiB / 74.6 KiB (21.45%)
Uploading C:\MegaFrogRace_Server\release-na:  32.0 KiB / 74.6 KiB (42.89%)
Uploading C:\MegaFrogRace_Server\release-na:  48.0 KiB / 74.6 KiB (64.34%)
Uploading C:\MegaFrogRace_Server\release-na:  64.0 KiB / 74.6 KiB (85.79%)
Uploading C:\MegaFrogRace_Server\release-na:  74.6 KiB / 74.6 KiB (100.00%)
Successfully uploaded C:\MegaFrogRace_Server\release-na to AWS GameLift
Build ID: build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Weitere Informationen finden Sie unter Hochladen eines benutzerdefinierten Server-Builds auf GameLift im Entwicklerhandbuch zu Amazon GameLift.

API-Details finden Sie unter UploadBuild in der AWS CLI-Befehlsreferenz.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

AWS FIS

Global Accelerator