As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
GameLift Exemplos da Amazon usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com a Amazon GameLift.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.
Tópicos
Ações
O código de exemplo a seguir mostra como usar create-build
.
- AWS CLI
-
Exemplo 1: Para criar uma compilação de jogo a partir de arquivos em um bucket do S3
O
create-build
exemplo a seguir cria um recurso personalizado de criação de jogos. Ele usa arquivos compactados que são armazenados em um local do S3 em uma AWS conta que você controla. Este exemplo pressupõe que você já tenha criado uma IAM função que dá GameLift permissão à Amazon para acessar a localização do S3. Como a solicitação não especifica um sistema operacional, o novo recurso de compilação usa como padrão _2012. WINDOWSaws gamelift create-build \ --storage-location
file://storage-loc.json
\ --nameMegaFrogRaceServer.NA
\ --build-version12345.678
Conteúdo de
storage-loc.json
:{ "Bucket":"MegaFrogRaceServer_NA_build_files" "Key":"MegaFrogRaceServer_build_123.zip" "RoleArn":"arn:aws:iam::123456789012:role/gamelift" }
Saída:
{ "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" } }
Exemplo 2: Para criar um recurso de criação de jogos para fazer upload manual de arquivos para GameLift
O
create-build
exemplo a seguir cria um novo recurso de compilação. Ele também obtém um local de armazenamento e credenciais temporárias que permitem que você faça o upload manual da compilação do jogo para o GameLift local no Amazon S3. Depois de carregar sua compilação com sucesso, o GameLift serviço valida a compilação e atualiza o status da nova compilação.aws gamelift create-build \ --name
MegaFrogRaceServer.NA
\ --build-version12345.678
\ --operating-systemAMAZON_LINUX
Saída:
{ "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==" } }
Para obter mais informações, consulte Fazer upload de uma compilação de servidor personalizada GameLift no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte CreateBuild
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-fleet
.
- AWS CLI
-
Exemplo 1: Para criar uma frota Linux básica
O
create-fleet
exemplo a seguir cria uma frota minimamente configurada de instâncias Linux sob demanda para hospedar uma criação de servidor personalizada. Você pode concluir a configuração usandoupdate-fleet
.aws gamelift create-fleet \ --name
MegaFrogRaceServer.NA.v2
\ --description 'Hosts for v2 North America
' \ --build-idbuild-1111aaaa-22bb-33cc-44dd-5555eeee66ff
\ --certificate-configuration 'CertificateType=GENERATED
' \ --ec2-instance-typec4.large
\ --fleet-typeON_DEMAND
\ --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/release-na/MegaFrogRace_Server.exe,ConcurrentExecutions=1}]
'Saída:
{ "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" } }
Exemplo 2: Para criar uma frota básica do Windows
O
create-fleet
exemplo a seguir cria uma frota minimamente configurada de instâncias spot do Windows para hospedar uma criação de servidor personalizada. Você pode concluir a configuração usandoupdate-fleet
.aws gamelift create-fleet \ --name
MegaFrogRace.NA.v2
\ --description 'Hosts for v2 North America
' \ --build-idbuild-2222aaaa-33bb-44cc-55dd-6666eeee77ff
\ --certificate-configuration 'CertificateType=GENERATED
' \ --ec2-instance-typec4.large
\ --fleet-typeSPOT
\ --runtime-configuration 'ServerProcesses=[{LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}]
'Saída:
{ "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" } }
Exemplo 3: Para criar uma frota totalmente configurada
O
create-fleet
exemplo a seguir cria uma frota de instâncias Spot do Windows para uma criação de servidor personalizada, com as configurações mais usadas fornecidas.aws gamelift create-fleet \ --name
MegaFrogRace.NA.v2
\ --description 'Hosts for v2 North America
' \ --build-idbuild-2222aaaa-33bb-44cc-55dd-6666eeee77ff
\ --certificate-configuration 'CertificateType=GENERATED
' \ --ec2-instance-typec4.large
\ --ec2-inbound-permissions 'FromPort=33435,ToPort=33435,IpRange=10.24.34.0/23,Protocol=UDP
' \ --fleet-typeSPOT
\ --new-game-session-protection-policyFullProtection
\ --runtime-configurationfile://runtime-config.json
\ --metric-groupsdefault
\ --instance-role-arn 'arn:aws:iam::444455556666:role/GameLiftS3Access
'Conteúdo 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}]
Saída:
{ "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" } } }
Exemplo 4: Para criar uma frota de servidores em tempo real
O
create-fleet
exemplo a seguir cria uma frota de instâncias spot com um script de configuração em tempo real que foi enviado para a Amazon GameLift. Todos os servidores em tempo real são implantados em máquinas Linux. Para fins deste exemplo, suponha que o script em tempo real carregado inclua vários arquivos de script, com aInit()
função localizada no arquivo de script chamadaMainScript.js
. Conforme mostrado, esse arquivo é identificado como o script de inicialização na configuração do tempo de execução.aws gamelift create-fleet \ --name
MegaFrogRace.NA.realtime
\ --description 'Mega Frog Race Realtime fleet
' \ --script-idscript-1111aaaa-22bb-33cc-44dd-5555eeee66ff
\ --ec2-instance-typec4.large
\ --fleet-typeSPOT
\ --certificate-configuration 'CertificateType=GENERATED
' --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/MainScript.js,Parameters=+map Winter444,ConcurrentExecutions=5}]
'Saída:
{ "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" } }
-
Para API obter detalhes, consulte CreateFleet
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-game-session-queue
.
- AWS CLI
-
Exemplo 1: Para configurar uma fila ordenada de sessões de jogo
O
create-game-session-queue
exemplo a seguir cria uma nova fila de sessões de jogo com destinos em duas regiões. Ele também configura a fila para que as solicitações da sessão do jogo expirem após esperar 10 minutos pela colocação. Como nenhuma política de latência está definida, GameLift tenta colocar todas as sessões de jogo com o primeiro destino listado.aws gamelift create-game-session-queue \ --name
MegaFrogRaceServer-NA
\ --destinationsfile://destinations.json
\ --timeout-in-seconds600
Conteúdo 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" } ] }
Saída:
{ "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"} ] } ] }
Exemplo 2: Para configurar uma fila de sessões de jogo com políticas de latência do jogador
O
create-game-session-queue
exemplo a seguir cria uma nova fila de sessões de jogo com políticas de latência para dois jogadores. A primeira política define um limite de latência de 100 ms que é aplicado durante o primeiro minuto de uma tentativa de colocação na sessão de jogo. A segunda política aumenta o limite de latência para 200 ms até que a solicitação de posicionamento expire em 3 minutos.aws gamelift create-game-session-queue \ --name
MegaFrogRaceServer-NA
\ --destinationsfile://destinations.json
\ --player-latency-policiesfile://latency-policies.json
\ --timeout-in-seconds180
Conteúdo 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" } ] }
Conteúdo de
latency-policies.json
:{ "PlayerLatencyPolicies": [ {"MaximumIndividualPlayerLatencyMilliseconds": 200}, {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60} ] }
Saída:
{ "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"} ], } }
Para obter mais informações, consulte Criar uma fila no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte CreateGameSessionQueue
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-build
.
- AWS CLI
-
Para excluir uma versão de jogo personalizada
O
delete-build
exemplo a seguir remove uma compilação da sua GameLift conta da Amazon. Depois que a compilação for excluída, você não poderá usá-la para criar novas frotas. Essa operação não pode ser desfeita.aws gamelift delete-build \ --build-id
build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Este comando não produz saída.
-
Para API obter detalhes, consulte DeleteBuild
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-fleet
.
- AWS CLI
-
Para excluir uma frota que não está mais em uso
O
delete-fleet
exemplo a seguir remove uma frota que foi reduzida para zero instâncias. Se a capacidade da frota for maior que zero, a solicitação falhará com um erro HTTP 400.aws gamelift delete-fleet \ --fleet-id
fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Este comando não produz saída.
Para obter mais informações, consulte Gerenciar GameLift frotas no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DeleteFleet
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-game-session-queue
.
- AWS CLI
-
Para excluir uma fila de sessões de jogo
O
delete-game-session-queue
exemplo a seguir exclui uma fila de sessão de jogo especificada.aws gamelift delete-game-session-queue \ --name
MegaFrogRace-NA
Este comando não produz saída.
-
Para API obter detalhes, consulte DeleteGameSessionQueue
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-build
.
- AWS CLI
-
Para obter informações sobre uma versão de jogo personalizada
O
describe-build
exemplo a seguir recupera propriedades de um recurso de criação de servidor de jogos.aws gamelift describe-build \ --build-id
build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Saída:
{ "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" } }
Para obter mais informações, consulte Fazer upload de uma compilação de servidor personalizada GameLift no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeBuild
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-ec2-instance-limits
.
- AWS CLI
-
Para recuperar os limites de serviço para um tipo de EC2 instância
O
describe-ec2-instance-limits
exemplo a seguir mostra o máximo permitido de instâncias e instâncias atuais em uso para o tipo de EC2 instância especificado na região atual. O resultado indica que apenas cinco das vinte instâncias permitidas estão sendo usadas.aws gamelift describe-ec2-instance-limits \ --ec2-instance-type
m5.large
Saída:
{ "EC2InstanceLimits": [ { "EC2InstanceType": ""m5.large", "CurrentInstances": 5, "InstanceLimit": 20 } ] }
Para obter mais informações, consulte Choose Computing Resources no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeEc2 InstanceLimits
em Referência de AWS CLI comandos.
-
O código de exemplo a seguir mostra como usar describe-fleet-attributes
.
- AWS CLI
-
Exemplo 1: Para visualizar os atributos de uma lista de frotas
O
describe-fleet-attributes
exemplo a seguir recupera os atributos da frota de duas frotas especificadas. Conforme mostrado, as frotas solicitadas são implantadas com a mesma construção, uma para instâncias sob demanda e outra para instâncias spot, com algumas pequenas diferenças de configuração.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
Saída:
{ "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" } } ] }
Exemplo 2: Para solicitar atributos para todas as frotas
O seguinte
describe-fleet-attributes
retorna os atributos da frota para todas as frotas com qualquer status. Este exemplo ilustra o uso de parâmetros de paginação para retornar uma frota por vez.aws gamelift describe-fleet-attributes \ --limit
1
Saída:
{ "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" }
A saída inclui um
NextToken
valor que você pode usar ao chamar o comando pela segunda vez. Passe o valor para o--next-token
parâmetro para especificar onde obter a saída. O comando a seguir retorna o segundo resultado na saída.aws gamelift describe-fleet-attributes \ --limit
1
\ --next-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1
Repita até que a resposta não inclua um
NextToken
valor.Para obter mais informações, consulte Configurando GameLift frotas no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeFleetAttributes
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-fleet-capacity
.
- AWS CLI
-
Para ver o status da capacidade de uma lista de frotas
O
describe-fleet-capacity
exemplo a seguir recupera a capacidade atual de duas frotas especificadas.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
Saída:
{ "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 } } ] }
Para obter mais informações, consulte GameLift Métricas para frotas no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeFleetCapacity
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-fleet-events
.
- AWS CLI
-
Para solicitar eventos para um período de tempo especificado
O
describe-fleet-events
exemplo a seguir exibe detalhes de todos os eventos relacionados à frota que ocorreram durante o período especificado.aws gamelift describe-fleet-events \ --fleet-id
arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
\ --start-time1579647600
\ --end-time1579649400
\ --limit5
Saída:
{ "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" }
Para obter mais informações, consulte Debug GameLift Fleet Issues no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeFleetEvents
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-fleet-port-settings
.
- AWS CLI
-
Para ver as permissões de conexão de entrada para uma frota
O
describe-fleet-port-settings
exemplo a seguir recupera as configurações de conexão de uma frota especificada.aws gamelift describe-fleet-port-settings \ --fleet-id
arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Saída:
{ "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" } ] }
Para obter mais informações, consulte Configurando GameLift frotas no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeFleetPortSettings
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-fleet-utilization
.
- AWS CLI
-
Exemplo 1: Para visualizar os dados de uso de uma lista de frotas
O
describe-fleet-utilization
exemplo a seguir recupera as informações de uso atuais de uma frota especificada.aws gamelift describe-fleet-utilization \ --fleet-ids
arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Saída:
{ "FleetUtilization": [ { "FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ActiveServerProcessCount": 100, "ActiveGameSessionCount": 62, "CurrentPlayerSessionCount": 329, "MaximumPlayerSessionCount": 1000 } ] }
Exemplo 2: Para solicitar dados de uso para todas as frotas
O seguinte
describe-fleet-utilization
retorna dados de uso da frota para todas as frotas com qualquer status. Este exemplo usa parâmetros de paginação para retornar dados de duas frotas ao mesmo tempo.aws gamelift describe-fleet-utilization \ --limit
2
Saída:
{ "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" }
Chame o comando pela segunda vez, passando o
NextToken
valor como argumento para o--next-token
parâmetro para ver os próximos dois resultados.aws gamelift describe-fleet-utilization \ --limit
2
\ --next-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2
Repita até que a resposta não inclua mais um
NextToken
valor na saída.Para obter mais informações, consulte GameLift Métricas para frotas no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeFleetUtilization
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-game-session-queues
.
- AWS CLI
-
Para ver as filas de sessões de jogo
O
describe-game-session-queues
exemplo a seguir recupera propriedades de duas filas especificadas.aws gamelift describe-game-session-queues \ --names
MegaFrogRace-NA
MegaFrogRace-EU
Saída:
{ "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" } ] }
Para obter mais informações, consulte Como usar filas multirregionais no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeGameSessionQueues
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-runtime-configuration
.
- AWS CLI
-
Para solicitar a configuração de tempo de execução de uma frota
O
describe-runtime-configuration
exemplo a seguir recupera detalhes sobre a configuração atual do tempo de execução de uma frota especificada.aws gamelift describe-runtime-configuration \ --fleet-id
fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Saída:
{ "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 } }
Para obter mais informações, consulte Executar vários processos em uma frota no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte DescribeRuntimeConfiguration
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-builds
.
- AWS CLI
-
Exemplo 1: Para obter uma lista de versões de jogos personalizadas
O
list-builds
exemplo a seguir recupera as propriedades de todas as compilações de servidores de jogos na região atual. O exemplo de solicitação ilustra como usar os parâmetros de paginaçãoLimit
e recuperarNextToken
os resultados em conjuntos sequenciais. O primeiro comando recupera as duas primeiras compilações. Como há mais de dois disponíveis, a resposta inclui umNextToken
para indicar que há mais resultados disponíveis.aws gamelift list-builds \ --limit
2
Saída:
{ "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=" }
Em seguida, você pode chamar o comando novamente com o
--next-token
parâmetro a seguir para ver as próximas duas compilações.aws gamelift list-builds \ --limit
2
--next-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=
Repita até que a resposta não inclua um
NextToken
valor.Exemplo 2: Para obter uma lista de compilações de jogos personalizadas em status de falha
O
list-builds
exemplo a seguir recupera propriedades de todas as compilações de servidores de jogos na região atual que atualmente têm status. FAILEDaws gamelift list-builds \ --status
FAILED
Saída:
{ "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" } ] }
-
Para API obter detalhes, consulte ListBuilds
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-fleets
.
- AWS CLI
-
Exemplo 1: Para obter uma lista de todas as frotas em uma região
O
list-fleets
exemplo a seguir mostra a frota IDs de todas as frotas na região atual. Este exemplo usa parâmetros de paginação para recuperar duas frotas por IDs vez. A resposta inclui umnext-token
atributo, que indica que há mais resultados a serem recuperados.aws gamelift list-fleets \ --limit
2
Saída:
{ "FleetIds": [ "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ], "NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=" }
Você pode passar o
NextToken
valor da resposta anterior no próximo comando, conforme mostrado aqui, para obter os próximos dois resultados.aws gamelift list-fleets \ --limit
2
\ --next-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=
Exemplo 2: Para obter uma lista de todas as frotas em uma região com uma construção ou script específico
O
list-builds
exemplo a seguir recupera as IDs frotas implantadas com a compilação de jogo especificada. Se você estiver trabalhando com servidores em tempo real, poderá fornecer uma ID de script no lugar de uma ID de compilação. Como esse exemplo não especifica o parâmetro limite, os resultados podem incluir até 16 frotasIDs.aws gamelift list-fleets \ --build-id
build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Saída:
{ "FleetIds": [ "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444" ] }
-
Para API obter detalhes, consulte ListFleets
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar request-upload-credentials
.
- AWS CLI
-
Para atualizar as credenciais de acesso para fazer o upload de uma compilação
O
create-build
exemplo a seguir obtém credenciais de acesso novas e válidas para carregar um arquivo de GameLift compilação em um local do Amazon S3. As credenciais têm uma vida útil limitada. Você obtém o ID da compilação da resposta àCreateBuild
solicitação original.aws gamelift request-upload-credentials \ --build-id
build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Saída:
{ "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==" } }
Para obter mais informações, consulte Fazer upload de uma compilação de servidor personalizada GameLift no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte RequestUploadCredentials
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar start-fleet-actions
.
- AWS CLI
-
Para reiniciar a atividade de escalonamento automático da frota
O
start-fleet-actions
exemplo a seguir retoma o uso de todas as políticas de escalabilidade definidas para a frota especificada, mas que foram interrompidas stop-fleet-actions chamando`` ``. Depois de começar, as políticas de escalabilidade começam imediatamente a monitorar suas respectivas métricas.aws gamelift start-fleet-actions \ --fleet-id
fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
\ --actionsAUTO_SCALING
Este comando não produz saída.
-
Para API obter detalhes, consulte StartFleetActions
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar stop-fleet-actions
.
- AWS CLI
-
Para interromper a atividade de escalonamento automático de uma frota
O
stop-fleet-actions
exemplo a seguir interrompe o uso de todas as políticas de escalabilidade definidas para a frota especificada. Depois que as políticas são suspensas, a capacidade da frota permanece na mesma contagem de instâncias ativas, a menos que você a ajuste manualmente.aws gamelift start-fleet-actions \ --fleet-id
fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
\ --actionsAUTO_SCALING
Este comando não produz saída.
-
Para API obter detalhes, consulte StopFleetActions
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-build
.
- AWS CLI
-
Para atualizar uma versão de jogo personalizada
O
update-build
exemplo a seguir altera as informações de nome e versão associadas a um recurso de compilação especificado. O objeto de construção retornado verifica se as alterações foram feitas com sucesso.aws gamelift update-build \ --build-id
build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
\ --nameMegaFrogRaceServer.NA.east
\ --build-version12345.east
Saída:
{ "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" } }
Para obter mais informações, consulte Atualizar seus arquivos de compilação no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte UpdateBuild
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-game-session-queue
.
- AWS CLI
-
Para atualizar a configuração da fila de uma sessão de jogo
O
update-game-session-queue
exemplo a seguir adiciona um novo destino e atualiza as políticas de latência do jogador para uma fila de sessão de jogo existente.aws gamelift update-game-session-queue \ --name
MegaFrogRace-NA
\ --destinationsfile://destinations.json
\ --player-latency-policiesfile://latency-policies.json
Conteúdo 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"} ] }
Conteúdo de
latency-policies.json
:{ "PlayerLatencyPolicies": [ {"MaximumIndividualPlayerLatencyMilliseconds": 200}, {"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120}, {"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120} ] }
Saída:
{ "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} ] } }
Para obter mais informações, consulte Como usar filas multirregionais no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte UpdateGameSessionQueue
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar upload-build
.
- AWS CLI
-
Exemplo 1: Para fazer o upload de uma compilação de servidor de jogos Linux
O
upload-build
exemplo a seguir carrega arquivos de compilação do servidor de jogos Linux de um diretório de arquivos para o GameLift serviço e cria um recurso de compilação.aws gamelift upload-build \ --name
MegaFrogRaceServer.NA
\ --build-version2.0.1
\ --build-root~/MegaFrogRace_Server/release-na
\ --operating-systemAMAZON_LINUX_2
--server-sdk-version4.0.2
Saída:
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
Exemplo 2: Para carregar uma compilação de servidor de jogos do Windows
O
upload-build
exemplo a seguir carrega arquivos de compilação do servidor de jogos Windows de um diretório para o GameLift serviço e cria um registro de compilação.aws gamelift upload-build \ --name
MegaFrogRaceServer.NA
\ --build-version2.0.1
\ --build-root C:\MegaFrogRace_Server\release-na \ --operating-systemWINDOWS_2012
--server-sdk-version4.0.2
Saída:
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
Para obter mais informações, consulte Fazer upload de uma compilação de servidor personalizada GameLift no Amazon GameLift Developer Guide.
-
Para API obter detalhes, consulte UploadBuild
na Referência de AWS CLI Comandos.
-