Exemples d'utilisation de Amazon GameLift Servers AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

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 façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

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

AWS CLI

Exemple1 : pour créer une version de jeu à partir de fichiers d'un compartiment S3

L'create-buildexemple suivant crée une ressource de compilation 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 compilation 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 compilation de jeu permettant de télécharger manuellement des fichiers vers GameLift

L'create-buildexemple suivant crée une nouvelle ressource de construction. 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 un parc Linux de base

L'create-fleetexemple suivant crée un parc d'instances Linux à la demande configuré de manière minimale pour héberger une version de serveur personnalisée. Vous pouvez terminer la configuration en utilisantupdate-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 un parc Windows de base

L'create-fleetexemple suivant crée un parc d'instances Windows ponctuelles configuré de manière minimale pour héberger une version de serveur personnalisée. Vous pouvez terminer la configuration en utilisantupdate-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'create-fleetexemple suivant crée un parc d'instances Spot Windows pour une construction de serveur personnalisée, avec les paramètres de configuration les plus couramment utilisés fournis.

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 un parc 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é inclut plusieurs fichiers de script, la Init() fonction située dans le fichier de script étant appeléeMainScript.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

Exemple1 : Pour configurer une file d'attente ordonnée pour les sessions de jeu

L'create-game-session-queueexemple suivant crée une nouvelle file d'attente de session 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 après 10 minutes d'attente pour être placées. 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 session de jeu avec des politiques de latence pour les joueurs

L'create-game-session-queueexemple suivant crée une nouvelle file d'attente de session de jeu avec des politiques de latence pour deux joueurs. La première règle définit un plafond de latence de 100 ms qui est appliqué pendant la première minute d'une tentative de placement de session de jeu. La deuxième politique augmente le plafond de latence à 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 une version de jeu personnalisée

L'delete-buildexemple suivant supprime un build de votre GameLift compte Amazon. Une fois le build supprimé, vous ne pouvez pas l'utiliser pour créer de nouvelles flottes. Cette opération ne peut pas être annulée.

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

Cette commande ne produit aucun résultat.

  • 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 un parc qui n'est plus utilisé

L'delete-fleetexemple suivant supprime une flotte qui a été réduite à zéro instance. Si la capacité du parc 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 aucun résultat.

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 session de jeu

L'delete-game-session-queueexemple suivant supprime une file d'attente de session de jeu spécifiée.

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

Cette commande ne produit aucun résultat.

  • 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 des informations sur une version de jeu personnalisée

L'describe-buildexemple suivant récupère les propriétés d'une ressource de compilation 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

Exemple1 : Pour afficher les attributs d'une liste de flottes

L'describe-fleet-attributesexemple suivant récupère les attributs de flotte pour deux flottes spécifiées. Comme indiqué, les flottes demandées sont déployées avec la même version, 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 des attributs pour toutes les flottes

Ce qui suit describe-fleet-attributes renvoie les attributs de flotte pour 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 NextToken valeur que vous pouvez utiliser lorsque vous appelez la commande une deuxième fois. Passez la valeur au --next-token paramètre 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 NextToken valeur.

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 capacité d'une liste de flottes

L'describe-fleet-capacityexemple suivant permet de récupérer 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 des événements pendant une période spécifiée

L'describe-fleet-eventsexemple suivant affiche les détails de tous les événements liés à la flotte 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 consulter les autorisations de connexion entrante pour une flotte

L'describe-fleet-port-settingsexemple suivant récupère les paramètres de connexion pour un parc spécifique.

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

Exemple1 : Pour afficher les données d'utilisation d'une liste de flottes

L'describe-fleet-utilizationexemple suivant permet de récupérer les informations d'utilisation actuelles pour un parc spécifique.

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 des données d'utilisation pour toutes les flottes

Ce qui suit describe-fleet-utilization renvoie les données d'utilisation de la flotte pour 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 NextToken valeur comme argument au --next-token paramètre 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 NextToken valeur 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 des sessions de jeu

L'describe-game-session-queuesexemple 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 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 la configuration d'exécution d'une flotte

L'describe-runtime-configurationexemple suivant permet de récupérer des informations sur la configuration d'exécution actuelle pour un parc spécifique.

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

Exemple1 : Pour obtenir une liste des versions de jeu personnalisées

L'list-buildsexemple suivant récupère les propriétés de toutes les versions de serveurs de jeu de la région actuelle. L'exemple de demande montre comment utiliser les paramètres de pagination Limit et comment récupérer NextToken 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 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 à nouveau la commande avec le --next-token paramètre suivant pour voir les deux prochaines versions.

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

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

Exemple 2 : Pour obtenir une liste des versions de jeu personnalisées en état d'échec

L'list-buildsexemple suivant récupère les propriétés de toutes les versions de serveurs de jeu de la région actuelle qui ont actuellement le statut 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

Exemple1 : 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 next-token attribut qui indique 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 NextToken valeur 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=

Exemple2 : Pour obtenir une liste de toutes les flottes d'une région avec une version 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 identifiant de script à la place d'un identifiant 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'accès pour le téléchargement d'une version

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. Les informations d'identification ont une durée de vie limitée. Vous obtenez l'ID de build à partir de la réponse à la CreateBuild demande 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 de la 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 démarrage, les politiques de dimensionnement 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 aucun résultat.

  • 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'stop-fleet-actionsexemple suivant arrête l'utilisation de toutes les politiques de dimensionnement définies pour le parc spécifié. Une fois les politiques suspendues, la capacité du parc 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 aucun résultat.

  • 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 une version de jeu personnalisée

L'update-buildexemple suivant modifie le nom et les informations de version associés à une ressource de génération spécifiée. L'objet de construction 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 session de jeu

L'update-game-session-queueexemple suivant ajoute une nouvelle destination et met à jour les politiques de latence des joueurs pour une file d'attente de session de jeu existante.

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

Exemple1 : Pour télécharger une version 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

Exemple2 : Pour télécharger une version 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.