Exemples d'utilisation de Amazon GameLift Servers AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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

Exemples d'utilisation de Amazon GameLift Servers AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide des GameLift serveurs Amazon.

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

L'exemple de code suivant montre comment utilisercreate-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 de build de jeu personnalisée. Il utilise des fichiers compressés qui sont stockés dans un emplacement S3 d'un AWS compte que vous contrôlez. Cet exemple suppose que vous avez déjà créé un rôle IAM qui GameLift autorise Amazon à accéder à l'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"
    }
}

Exemple2 : Pour créer une ressource de compilation de jeu permettant de télécharger manuellement des fichiers vers GameLift

L’exemple create-build suivant crée une ressource de build. Il dispose également d'un emplacement de stockage et d'informations d'identification temporaires qui vous permettent de télécharger manuellement votre build de GameLift jeu sur Amazon S3. Une fois que vous avez chargé votre build avec succès, le GameLift service valide le build et met à jour le statut 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 la section Upload a custom server build to GameLift dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous CreateBuildà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-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'create-fleetexemple suivant crée un parc 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, reportez-vous CreateFleetà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-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. Aucune politique de latence n'étant définie, GameLift tente de placer toutes les sessions de jeu avec 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 la section Créer une file d'attente dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous CreateGameSessionQueueà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-build.

AWS CLI

Pour supprimer un build de jeu personnalisé

L'delete-buildexemple suivant supprime un build de votre GameLift compte Amazon. 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, reportez-vous DeleteBuildà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-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 la section Gérer les GameLift flottes dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous DeleteFleetà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-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, reportez-vous DeleteGameSessionQueueà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-build.

AWS CLI

Pour obtenir les informations sur un build de jeu personnalisé

L’exemple describe-build suivant extrait 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 la section Upload a custom server build to GameLift dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous DescribeBuildà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-ec2-instance-limits.

AWS CLI

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

L'describe-ec2-instance-limitsexemple suivant affiche le nombre maximum d'instances autorisées et les instances actuellement utilisées pour le type d' EC2 instance 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 Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous à la section DescribeEc2 InstanceLimits de AWS CLI la section Référence des commandes.

L'exemple de code suivant montre comment utiliserdescribe-fleet-attributes.

AWS CLI

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

L’exemple describe-fleet-attributes suivant extrait 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

describe-fleet-attributes ci-dessous 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 la section Configuration GameLift des flottes dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous DescribeFleetAttributesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-fleet-capacity.

AWS CLI

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

L’exemple describe-fleet-capacity suivant extrait 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 la section GameLift Metrics for Fleets dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous DescribeFleetCapacityà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-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 la section Debug GameLift Fleet Issues dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous DescribeFleetEventsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-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 la section Configuration GameLift des flottes dans le manuel Amazon GameLift Developer Guide.

L'exemple de code suivant montre comment utiliserdescribe-fleet-utilization.

AWS CLI

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

L’exemple describe-fleet-utilization suivant extrait 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

describe-fleet-utilization ci-dessous 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 la section GameLift Metrics for Fleets dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous DescribeFleetUtilizationà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-game-session-queues.

AWS CLI

Pour afficher les files d’attente de sessions de jeu

L’exemple describe-game-session-queues suivant extrait 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 la section Utilisation des files d'attente multirégionales dans le manuel Amazon GameLift Developer Guide.

L'exemple de code suivant montre comment utiliserdescribe-runtime-configuration.

AWS CLI

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

L’exemple describe-runtime-configuration suivant extrait des 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 la section Exécuter plusieurs processus sur un parc dans le manuel Amazon GameLift Developer Guide.

L'exemple de code suivant montre comment utiliserlist-builds.

AWS CLI

Exemple 1 : pour obtenir une liste des builds de jeu personnalisés

L’exemple list-builds suivant extrait 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 extraire les résultats dans des ensembles séquentiels. La première commande extrait 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 obtenir une liste des builds de jeu personnalisés à l’état d’échec

L’exemple list-builds suivant extrait 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, reportez-vous ListBuildsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-fleets.

AWS CLI

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

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

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'list-buildsexemple suivant récupère les IDs flottes déployées avec la version de jeu spécifiée. Si vous travaillez avec des serveurs en temps réel, vous pouvez fournir un ID de script à la place d’un ID de build. Comme cet exemple ne spécifie pas le paramètre de limite, les résultats peuvent inclure jusqu'à 16 flottes IDs.

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, reportez-vous ListFleetsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserrequest-upload-credentials.

AWS CLI

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

L'create-buildexemple suivant permet d'obtenir de nouvelles informations d'accès valides pour le téléchargement d'un fichier de GameLift build vers un emplacement Amazon S3. Ces informations d’identification ont une durée de vie limitée. Vous obtenez l’ID de build à 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 la section Upload a custom server build to GameLift dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous RequestUploadCredentialsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstart-fleet-actions.

AWS CLI

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

L'start-fleet-actionsexemple suivant reprend l'utilisation de toutes les politiques de dimensionnement définies pour le parc spécifié mais qui ont été arrêtées en stop-fleet-actions appelant`` ``. 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, reportez-vous StartFleetActionsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstop-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, reportez-vous StopFleetActionsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-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 Mettre à jour vos fichiers de compilation dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous UpdateBuildà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-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 la section Utilisation des files d'attente multirégionales dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous UpdateGameSessionQueueà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupload-build.

AWS CLI

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

L'upload-buildexemple suivant télécharge les fichiers de build d'un serveur de jeu Linux depuis un répertoire de fichiers vers le GameLift service et crée une ressource de compilation.

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'upload-buildexemple suivant télécharge les fichiers de build du serveur de jeu Windows depuis un répertoire vers le GameLift service 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 la section Upload a custom server build to GameLift dans le manuel Amazon GameLift Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous UploadBuildà la section Référence des AWS CLI commandes.