Exemples d’utilisation de l’AWS CLI avec Amazon GameLift Servers

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Amazon GameLift Servers.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

Actions

L’exemple de code suivant montre comment utiliser create-build.

AWS CLI

Exemple 1 : pour créer un build de jeu à partir des fichiers d’un compartiment S3

L’exemple create-build suivant crée une ressource personnalisée de build de jeu. Il utilise des fichiers compressés qui sont stockés à l’emplacement S3 d’un compte AWS que vous contrôlez. Cet exemple suppose que vous ayez déjà créé un rôle IAM qui autorise Amazon GameLift à accéder à cet emplacement S3. Étant donné que la demande ne spécifie aucun système d’exploitation, la nouvelle ressource de génération est par défaut WINDOWS_2012.


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

Contenu de storage-loc.json :


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

Sortie :


{
    "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"
    }
}

Exemple 2 : pour créer une ressource de build de jeu permettant de charger manuellement des fichiers dans GameLift

L’exemple create-build suivant crée une ressource de build. Il génère également un emplacement de stockage et des informations d’identification temporaires qui vous permettent de charger manuellement votre build de jeu à l’emplacement de GameLift dans Amazon S3. Une fois que vous avez chargé le build, le service GameLift le valide et met à jour l’état du nouveau build.


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

Sortie :


{
    "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=="
    }
}

Pour plus d’informations, consultez Upload a Custom Server Build to GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez CreateBuild dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-fleet.

AWS CLI

Exemple 1 : pour créer une flotte Linux de base

L’exemple create-fleet suivant crée une flotte d’instances Linux à la demande configurée de manière minimale pour héberger un build de serveur personnalisé. Vous pouvez mener à bien la configuration avec update-fleet.


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}]'

Sortie :


{
    "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"
    }
}

Exemple 2 : pour créer une flotte Windows de base

L’exemple create-fleet suivant crée une flotte d’instances Spot Windows configurée de manière minimale pour héberger un build de serveur personnalisé. Vous pouvez mener à bien la configuration avec update-fleet.


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}]'

Sortie :


{
    "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"
    }
}

Exemple 3 : pour créer une flotte entièrement configurée

L’exemple create-fleet suivant crée une flotte d’instances Spot Windows pour un build de serveur personnalisé, en fournissant les paramètres de configuration les plus couramment utilisés.


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'

Contenu de 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}]

Sortie :


{
    "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"
        }
    }
}

Exemple 4 : pour créer une flotte de serveurs en temps réel

L’exemple create-fleet suivant crée une flotte d’instances Spot avec un script de configuration en temps réel qui a été chargé sur Amazon GameLift. Tous les serveurs en temps réel sont déployés sur des machines Linux. Pour les besoins de cet exemple, supposons que le script en temps réel chargé comprenne plusieurs fichiers de script et que la fonction Init() située dans le fichier de script s’appelle MainScript.js. Comme indiqué, ce fichier est identifié comme le script de lancement dans la configuration d’exécution.


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}]'

Sortie :


{
    "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"
    }
}

Pour plus de détails sur l’API, consultez CreateFleet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-game-session-queue.

AWS CLI

Exemple 1 : pour configurer une file d’attente ordonnée pour les sessions de jeu

L’exemple create-game-session-queue suivant crée une file d’attente de sessions de jeu avec des destinations dans deux régions. Il configure également la file d’attente de manière à ce que les demandes de session de jeu expirent lorsqu’elles ne sont pas placées au bout de 10 minutes. Comme aucune politique de latence n’est définie, GameLift essaie de placer toutes les sessions de jeu auprès de la première destination répertoriée.


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

Contenu de 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" }
    ]
}

Sortie :


{
    "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"}
            ]
        }
    ]
}

Exemple 2 : pour configurer une file d’attente de sessions de jeu avec des politiques de latence pour les joueurs

L’exemple create-game-session-queue suivant crée une file d’attente de sessions de jeu avec des politiques de latence pour deux joueurs. La première politique définit un plafond de latence de 100 ms qui est appliqué pendant la première minute d’une tentative de placement d’une session de jeu. La deuxième politique augmente ce plafond de latence en le faisant passer à 200 ms jusqu’à ce que la demande de placement expire au bout de 3 minutes.


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

Contenu de 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" }
    ]
}

Contenu de latency-policies.json :


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

Sortie :


{
    "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"}
        ],
    }
}

Pour plus d’informations, consultez Create a Queue dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez CreateGameSessionQueue dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-build.

AWS CLI

Pour supprimer un build de jeu personnalisé

L’exemple delete-build suivant supprime un build de votre compte Amazon GameLift. Une fois le build supprimé, vous ne pouvez plus l’utiliser pour créer des flottes. Cette opération est irréversible.


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

Cette commande ne produit aucune sortie.

Pour plus de détails sur l’API, consultez DeleteBuild dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-fleet.

AWS CLI

Pour supprimer une flotte qui n’est plus utilisée

L’exemple delete-fleet suivant supprime une flotte qui a été réduite verticalement à zéro instance. Si la capacité de la flotte est supérieure à zéro, la demande échoue avec une erreur HTTP 400.


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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Gestion des flottes GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DeleteFleet dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-game-session-queue.

AWS CLI

Pour supprimer une file d’attente de sessions de jeu

L’exemple delete-game-session-queue suivant supprime une file d’attente de sessions de jeu spécifiée.


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

Cette commande ne produit aucune sortie.

Pour plus de détails sur l’API, consultez DeleteGameSessionQueue dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-build.

AWS CLI

Pour obtenir les informations sur un build de jeu personnalisé

L’exemple describe-build suivant récupère les propriétés d’une ressource de build d’un serveur de jeu.


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

Sortie :


{
    "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"
    }
}

Pour plus d’informations, consultez Upload a Custom Server Build to GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeBuild dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-ec2-instance-limits.

AWS CLI

Pour récupérer les limites de service d’un type d’instance EC2

L’exemple describe-ec2-instance-limits suivant affiche le nombre maximal d’instances autorisées et les instances actuellement utilisées pour le type d’instance EC2 spécifié dans la région actuelle. Le résultat indique que seules cinq des vingt instances autorisées sont utilisées.


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

Sortie :


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

Pour plus d’informations, consultez Choose Computing Resources dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeEc2InstanceLimits dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-fleet-attributes.

AWS CLI

Exemple 1 : pour afficher les attributs d’une liste de flottes

L’exemple describe-fleet-attributes suivant récupère les attributs de deux flottes spécifiées. Comme indiqué, les flottes demandées sont déployées avec le même build, une pour les instances à la demande et une pour les instances Spot, avec quelques différences de configuration mineures.


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

Sortie :


{
    "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"
            }
        }
    ]
}

Exemple 2 : pour demander les attributs de toutes les flottes

L’exemple describe-fleet-attributes suivant renvoie les attributs de toutes les flottes, quel que soit leur statut. Cet exemple illustre l’utilisation de paramètres de pagination pour renvoyer une flotte à la fois.


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

Sortie :


{
    "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"
}

La sortie inclut une valeur NextToken que vous pouvez utiliser lorsque vous appelez la commande une deuxième fois. Transmettez la valeur au paramètre --next-token pour spécifier où récupérer la sortie. La commande suivante renvoie le deuxième résultat dans la sortie.


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

Répétez l’opération jusqu’à ce que la réponse n’inclue aucune valeur NextToken.

Pour plus d’informations, consultez Configuration des flottes GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeFleetAttributes dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-fleet-capacity.

AWS CLI

Pour consulter l’état de la capacité d’une liste de flottes

L’exemple describe-fleet-capacity suivant récupère la capacité actuelle de deux flottes spécifiées.


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

Sortie :


{
    "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
            }
        }

    ]
}

Pour plus d’informations, consultez Métriques GameLift pour les flottes dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeFleetCapacity dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-fleet-events.

AWS CLI

Pour demander les événements survenus pendant une période spécifiée

L’exemple describe-fleet-events suivant affiche les détails de tous les événements liés à une flotte et survenus au cours de la période spécifiée.


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

Sortie :


{
    "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"
}

Pour plus d’informations, consultez Résolution des problèmes liés à la flotte GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeFleetEvents dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-fleet-port-settings.

AWS CLI

Pour afficher les autorisations de connexion entrante d’une flotte

L’exemple describe-fleet-port-settings suivant récupère les paramètres de connexion d’une flotte spécifiée.


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

Sortie :


{
    "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"
        }
    ]
}

Pour plus d’informations, consultez Configuration des flottes GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeFleetPortSettings dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-fleet-utilization.

AWS CLI

Exemple 1 : pour afficher les données d’utilisation d’une liste de flottes

L’exemple describe-fleet-utilization suivant récupère les informations d’utilisation actuelles d’une flotte spécifiée.


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

Sortie :


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

Exemple 2 : pour demander les données d’utilisation de toutes les flottes

L’exemple describe-fleet-utilization suivant renvoie les données d’utilisation de toutes les flottes, quel que soit leur statut. Cet exemple utilise des paramètres de pagination pour renvoyer des données pour deux flottes à la fois.


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

Sortie :


{
    "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"
}

Appelez la commande une deuxième fois, en transmettant la valeur NextToken comme argument au paramètre --next-token pour voir les deux résultats suivants.


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

Répétez l’opération jusqu’à ce que la réponse n’inclue plus de valeur NextToken dans la sortie.

Pour plus d’informations, consultez Métriques GameLift pour les flottes dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeFleetUtilization dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-game-session-queues.

AWS CLI

Pour afficher les files d’attente de sessions de jeu

L’exemple describe-game-session-queues suivant récupère les propriétés de deux files d’attente spécifiées.


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

Sortie :


{
    "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"
        }
    ]
}

Pour plus d’informations, consultez Using Multi-Region Queues dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeGameSessionQueues dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-runtime-configuration.

AWS CLI

Pour demander une configuration d’exécution pour une flotte

L’exemple describe-runtime-configuration suivant récupère les détails sur la configuration d’exécution actuelle d’une flotte spécifiée.


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

Sortie :


{
    "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
    }
}

Pour plus d’informations, consultez Exécution de plusieurs processus dans une flotte dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez DescribeRuntimeConfiguration dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-builds.

AWS CLI

Exemple 1 : pour générer une liste des builds de jeu personnalisés

L’exemple list-builds suivant récupère les propriétés de tous les builds de serveurs de jeu de la région actuelle. L’exemple de demande montre comment utiliser les paramètres de pagination, Limit et NextToken, et comment récupérer les résultats dans des ensembles séquentiels. La première commande récupère les deux premières versions. Comme il y en a plus de deux, la réponse inclut un attribut NextToken pour indiquer que d’autres résultats sont disponibles.


aws gamelift list-builds \
    --limit 2

Sortie :


{
    "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="
}

Vous pouvez ensuite appeler la commande à nouveau avec le paramètre --next-token, comme suit, pour voir les deux builds suivants.


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

Répétez l’opération jusqu’à ce que la réponse n’inclue aucune valeur NextToken.

Exemple 2 : pour générer une liste des builds de jeu personnalisés à l’état d’échec

L’exemple list-builds suivant récupère les propriétés de tous les builds de serveurs de jeu de la région actuelle qui présentent actuellement l’état FAILED.


aws gamelift list-builds \
    --status FAILED

Sortie :


{
    "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"
        }
    ]
}

Pour plus de détails sur l’API, consultez ListBuilds dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-fleets.

AWS CLI

Exemple 1 : pour générer la liste de toutes les flottes d’une région

L’exemple list-fleets suivant affiche les identifiants de toutes les flottes de la région actuelle. Cet exemple utilise des paramètres de pagination pour récupérer deux identifiants de flotte à la fois. La réponse inclut un attribut next-token indiquant qu’il y a d’autres résultats à récupérer.


aws gamelift list-fleets \
    --limit 2

Sortie :


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

Vous pouvez transmettre la valeur NextToken de la réponse précédente dans la commande suivante, comme indiqué ici pour obtenir les deux résultats suivants.


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

Exemple 2 : pour générer une liste de toutes les flottes d’une région avec un build ou un script spécifique

L’exemple list-builds suivant récupère les identifiants des flottes déployées avec le build de jeu spécifié. Si vous travaillez avec des serveurs en temps réel, vous pouvez fournir un ID de script à la place d’un ID de génération. Comme cet exemple ne spécifie pas le paramètre de limite, les résultats peuvent inclure jusqu’à 16 identifiants de flotte.


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

Sortie :


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

Pour plus de détails sur l’API, consultez ListFleets dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser request-upload-credentials.

AWS CLI

Pour actualiser les informations d’identification pour le chargement d’un build

L’exemple create-build suivant génère de nouvelles informations d’identification valides pour charger un fichier de build GameLift vers un emplacement Amazon S3. Ces informations d’identification ont une durée de vie limitée. Vous obtenez l’ID de génération à partir de la réponse à la demande CreateBuild d’origine.


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

Sortie :


{
    "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=="
    }
}

Pour plus d’informations, consultez Upload a Custom Server Build to GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez RequestUploadCredentials dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser start-fleet-actions.

AWS CLI

Pour relancer l’activité de mise à l’échelle automatique d’une flotte

L’exemple start-fleet-actions suivant relance l’utilisation de toutes les politiques de mise à l’échelle définies pour la flotte spécifiée, mais qui ont été arrêtées en appelant « stop-fleet-actions ». Après le lancement, les politiques de mise à l’échelle commencent immédiatement à suivre leurs indicateurs respectifs.


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

Cette commande ne produit aucune sortie.

Pour plus de détails sur l’API, consultez StartFleetActions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser stop-fleet-actions.

AWS CLI

Pour arrêter l’activité de mise à l’échelle automatique d’une flotte

L’exemple stop-fleet-actions suivant arrête l’utilisation de toutes les politiques de mise à l’échelle définies pour la flotte spécifiée. Une fois les politiques suspendues, la capacité de la flotte reste au même niveau que le nombre d’instances actives, sauf si vous l’ajustez manuellement.


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

Cette commande ne produit aucune sortie.

Pour plus de détails sur l’API, consultez StopFleetActions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-build.

AWS CLI

Pour mettre à jour un build de jeu personnalisé

L’exemple update-build suivant modifie le nom et les informations de build associés à une ressource de build spécifiée. L’objet de build renvoyé vérifie que les modifications ont été effectuées avec succès.


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

Sortie :


{
    "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"
    }
}

Pour plus d’informations, consultez Mise à jour de vos fichiers de version de génération dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez UpdateBuild dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-game-session-queue.

AWS CLI

Pour mettre à jour la configuration d’une file d’attente de sessions de jeu

L’exemple update-game-session-queue suivant ajoute une nouvelle destination et met à jour les politiques de latence des joueurs pour une file d’attente de sessions de jeu.


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

Contenu de 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"}
    ]
}

Contenu de latency-policies.json :


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

Sortie :


{
    "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}
        ]
    }
}

Pour plus d’informations, consultez Using Multi-Region Queues dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez UpdateGameSessionQueue dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser upload-build.

AWS CLI

Exemple 1 : pour charger un build de serveur de jeu Linux

L’exemple upload-build suivant charge les fichiers de build d’un serveur de jeu Linux à partir d’un répertoire de fichiers vers le service GameLift et crée une ressource de build.


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

Sortie :


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

Exemple 2 : pour charger un build de serveur de jeu Windows

L’exemple upload-build suivant charge les fichiers de build du serveur de jeu Windows à partir d’un répertoire vers le service GameLift et crée un enregistrement de build.


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

Sortie :


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

Pour plus d’informations, consultez Upload a Custom Server Build to GameLift dans le Manuel du développeur Amazon GameLift.

Pour plus de détails sur l’API, consultez UploadBuild dans la Référence des commandes de l’AWS CLI.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

AWS FIS

Global Accelerator