**Esta documentação é somente para a versão 1 da AWS CLI.**
Anunciamos o próximo fim do suporte para a AWS CLI versão 1. É recomendável migrar para a AWS CLI versão 2. Para saber as datas e receber detalhes e informações adicionais sobre como migrar, consulte o [anúncio](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Para obter a documentação relacionada à AWS CLI versão 2, consulte o [Guia do usuário da versão 2](https://docs.aws.amazon.com/cli/latest/userguide/).
# Exemplos de Servidores do Amazon GameLift usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com Servidores do 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 perfis 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, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-build`
O código de exemplo a seguir mostra como usar `create-build`.
**AWS CLI**
**Exemplo 1: criar uma compilação de jogo a partir de arquivos em um bucket do S3**
O exemplo `create-build` a seguir cria um recurso personalizado de compilação de jogo. Ele usa arquivos compactados armazenados em um local S3 em uma AWS conta controlada por você. Este exemplo considera que você já tenha criado um perfil do IAM que dá permissão ao Amazon GameLift para acessar o local S3. Como a solicitação não especifica um sistema operacional, o novo recurso de compilação tem como padrão o WINDOWS\$12012.
```
aws gamelift create-build \
--storage-location file://storage-loc.json \
--name MegaFrogRaceServer.NA \
--build-version 12345.678
```
Conteúdo de `storage-loc.json`:
```
{
"Bucket":"MegaFrogRaceServer_NA_build_files"
"Key":"MegaFrogRaceServer_build_123.zip"
"RoleArn":"arn:aws:iam::123456789012:role/gamelift"
}
```
Resultado:
```
{
"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: criar um recurso de compilação de jogo para carregar arquivos manualmente no GameLift**
O exemplo `create-build` a seguir cria um novo recurso de compilação. Também obtém um local de armazenamento e credenciais temporárias que lhe permitem fazer o upload manual da compilação do jogo para o local do GameLift no Amazon S3. Depois de carregar sua compilação com sucesso, o serviço GameLift valida e atualiza o status da nova compilação.
```
aws gamelift create-build \
--name MegaFrogRaceServer.NA \
--build-version 12345.678 \
--operating-system AMAZON_LINUX
```
Resultado:
```
{
"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 para o GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) no Guia do desenvolvedor do Amazon *GameLift*.
+ Para ver detalhes da API, consulte [CreateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-build.html) na *Referência de comandos da AWS CLI*.
### `create-fleet`
O código de exemplo a seguir mostra como usar `create-fleet`.
**AWS CLI**
**Exemplo 1: criar uma frota Linux básica**
O exemplo `create-fleet` a seguir cria uma frota minimamente configurada de instâncias Linux sob demanda para hospedar uma compilação de servidor personalizada. É possível concluir a configuração usando `update-fleet`.
```
aws gamelift create-fleet \
--name MegaFrogRaceServer.NA.v2 \
--description 'Hosts for v2 North America' \
--build-id build-1111aaaa-22bb-33cc-44dd-5555eeee66ff \
--certificate-configuration 'CertificateType=GENERATED' \
--ec2-instance-type c4.large \
--fleet-type ON_DEMAND \
--runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/release-na/MegaFrogRace_Server.exe,ConcurrentExecutions=1}]'
```
Resultado:
```
{
"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: criar uma frota básica do Windows**
O exemplo `create-fleet` a seguir cria uma frota minimamente configurada de instâncias locais do Windows para hospedar uma compilação de servidor personalizada. É possível concluir a configuração usando `update-fleet`.
```
aws gamelift create-fleet \
--name MegaFrogRace.NA.v2 \
--description 'Hosts for v2 North America' \
--build-id build-2222aaaa-33bb-44cc-55dd-6666eeee77ff \
--certificate-configuration 'CertificateType=GENERATED' \
--ec2-instance-type c4.large \
--fleet-type SPOT \
--runtime-configuration 'ServerProcesses=[{LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}]'
```
Resultado:
```
{
"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: criar uma frota totalmente configurada**
O exemplo `create-fleet` a seguir cria uma frota de instâncias do Spot Windows para uma compilação de servidor personalizada, com as definições de configuração mais comumente usadas.
```
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'
```
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}]
```
Resultado:
```
{
"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: criar uma frota de servidores Realtime**
O exemplo `create-fleet` a seguir cria uma frota de instâncias spot com um script de configuração do Realtime carregado no Amazon GameLift. Todos os servidores Realtime são implantados em máquinas Linux. No caso deste exemplo, suponha que o script Realtime carregado inclua vários arquivos de script, com a função `Init()` localizada no arquivo de script chamado `MainScript.js`. Conforme demonstrado, identifica-se o arquivo como o script de inicialização na configuração de runtime.
```
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}]'
```
Resultado:
```
{
"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 ver detalhes da API, consulte [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-fleet.html) na *Referência de comandos da AWS CLI*.
### `create-game-session-queue`
O código de exemplo a seguir mostra como usar `create-game-session-queue`.
**AWS CLI**
**Exemplo 1: configurar uma fila ordenada de sessões de jogo**
O exemplo `create-game-session-queue` a seguir cria uma nova fila de sessões de jogo com destinos em duas regiões. Ele também configura a fila de modo que as solicitações de sessão de jogo sejam encerradas após 10 minutos de espera pelo posicionamento. Como não há políticas de latência definidas, o GameLift tenta colocar todas as sessões de jogo no primeiro destino listado.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--timeout-in-seconds 600
```
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" }
]
}
```
Resultado:
```
{
"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: configurar uma fila de sessões de jogo com políticas de latência de jogador**
O exemplo `create-game-session-queue` cria uma nova fila de sessão de jogo com duas políticas de latência de jogador. A primeira política define um limite de latência de 100 ms que é aplicado durante o primeiro minuto de uma tentativa de posicionamento de sessão de jogo. A segunda política aumenta o limite de latência para 200 ms até que a solicitação de posicionamento atinja o tempo limite em 3 minutos.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json \
--timeout-in-seconds 180
```
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}
]
}
```
Resultado:
```
{
"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](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html#queues-creating-cli) no *Guia do desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [CreateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session-queue.html) na *Referência de comandos da AWS CLI*.
### `delete-build`
O código de exemplo a seguir mostra como usar `delete-build`.
**AWS CLI**
**Excluir uma compilação de jogo personalizada**
O exemplo `delete-build` a seguir remove uma compilação da sua conta Amazon GameLift. Depois que a compilação for excluída, você não poderá usá-la para criar novas frotas. Esta 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 ver detalhes da API, consulte [DeleteBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-build.html) na *Referência de comandos da AWS CLI*.
### `delete-fleet`
O código de exemplo a seguir mostra como usar `delete-fleet`.
**AWS CLI**
**Excluir uma frota que não mais está em uso**
O exemplo `delete-fleet` a seguir remove uma frota que foi reduzida para zero instâncias. Se a capacidade da frota for maior que zero, a solicitação apresentará uma falha com 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 frotas do GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-editing.html) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DeleteFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-fleet.html) na *Referência de comandos da AWS CLI*.
### `delete-game-session-queue`
O código de exemplo a seguir mostra como usar `delete-game-session-queue`.
**AWS CLI**
**Excluir uma fila de sessões de jogo**
O exemplo `delete-game-session-queue` a seguir exclui uma fila de sessão de jogo específica.
```
aws gamelift delete-game-session-queue \
--name MegaFrogRace-NA
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-game-session-queue.html) na *Referência de comandos da AWS CLI*.
### `describe-build`
O código de exemplo a seguir mostra como usar `describe-build`.
**AWS CLI**
**Obter informações sobre uma compilação de jogo personalizada**
O exemplo `describe-build` a seguir recupera as propriedades de um recurso de compilação do servidor de jogos.
```
aws gamelift describe-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Resultado:
```
{
"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 para o GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-builds) no Guia do desenvolvedor do Amazon *GameLift*.
+ Para ver detalhes da API, consulte [DescribeBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-build.html) na *Referência de comandos da AWS CLI*.
### `describe-ec2-instance-limits`
O código de exemplo a seguir mostra como usar `describe-ec2-instance-limits`.
**AWS CLI**
**Recuperar os limites de serviço para um tipo de instância EC2**
O exemplo `describe-ec2-instance-limits` exibe as instâncias máximas permitidas e as atuais que estão em uso para o tipo de instância EC2 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
```
Resultado:
```
{
"EC2InstanceLimits": [
{
"EC2InstanceType": ""m5.large",
"CurrentInstances": 5,
"InstanceLimit": 20
}
]
}
```
Para obter mais informações, consulte [Escolher recursos de computação](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeEc2InstanceLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-ec2-instance-limits.html) na *Referência de comandos da AWS CLI*.
### `describe-fleet-attributes`
O código de exemplo a seguir mostra como usar `describe-fleet-attributes`.
**AWS CLI**
**Exemplo 1: visualizar os atributos de uma lista de frotas**
O exemplo `describe-fleet-attributes` a seguir recupera os atributos de frota para duas frotas específicas. Conforme demonstrado, as frotas solicitadas são implementadas com a mesma compilaçã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
```
Resultado:
```
{
"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: solicitar atributos para todas as frotas**
O seguinte `describe-fleet-attributes` retorna os atributos de frota para todas as frotas com qualquer status. Este exemplo ilustra o uso de parâmetros de paginação para retornar uma frota de cada vez.
```
aws gamelift describe-fleet-attributes \
--limit 1
```
Resultado:
```
{
"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 valor `NextToken` que pode ser usado quando o comando for chamado uma segunda vez. Passe o valor para o parâmetro `--next-token` a fim de especificar onde coletar a saída. O comando a seguir retorna o segundo resultado na saída.
```
aws gamelift describe-fleet-attributes \
--limit 1 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1
```
Repita até que a resposta não inclua um `NextToken` valor.
Para obter mais informações, consulte [Configurar frotas do GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeFleetAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-attributes.html) na *Referência de comandos da AWS CLI*.
### `describe-fleet-capacity`
O código de exemplo a seguir mostra como usar `describe-fleet-capacity`.
**AWS CLI**
**Visualizar o status da capacidade de uma lista de frotas**
O exemplo `describe-fleet-capacity` a seguir recupera a capacidade atual de duas frotas específicas.
```
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
```
Resultado:
```
{
"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 [Métricas do GameLift para Frotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeFleetCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-capacity.html) na *Referência de comandos da AWS CLI*.
### `describe-fleet-events`
O código de exemplo a seguir mostra como usar `describe-fleet-events`.
**AWS CLI**
**Solicitar eventos para um período de tempo específico**
O exemplo `describe-fleet-events` a seguir exibe detalhes de todos os eventos relacionados à frota que ocorreram durante o intervalo de tempo especificado.
```
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
```
Resultado:
```
{
"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"
}
```
For more information, see [Depurar problemas do GameLift Fleet](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html) no *Guia do desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeFleetEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-events.html) na *Referência de comandos da AWS CLI*.
### `describe-fleet-port-settings`
O código de exemplo a seguir mostra como usar `describe-fleet-port-settings`.
**AWS CLI**
**Visualizar permissões de conexão de entrada de uma frota**
O exemplo `describe-fleet-port-settings` a seguir recupera as configurações de conexão de uma frota específica.
```
aws gamelift describe-fleet-port-settings \
--fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Resultado:
```
{
"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 [Configurar frotas do GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeFleetPortSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-port-settings.html) na *Referência de comandos da AWS CLI*.
### `describe-fleet-utilization`
O código de exemplo a seguir mostra como usar `describe-fleet-utilization`.
**AWS CLI**
**Exemplo 1: visualizar os dados de uso de uma lista de frotas**
O exemplo `describe-fleet-utilization` a seguir recupera informações de uso atual de uma frota específica.
```
aws gamelift describe-fleet-utilization \
--fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Resultado:
```
{
"FleetUtilization": [
{
"FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"ActiveServerProcessCount": 100,
"ActiveGameSessionCount": 62,
"CurrentPlayerSessionCount": 329,
"MaximumPlayerSessionCount": 1000
}
]
}
```
**Exemplo 2: solicitar dados de uso para todas as frotas**
O seguinte `describe-fleet-utilization` retorna dados de uso de frota para todas as frotas com qualquer status. Este exemplo usa parâmetros de paginação para retornar dados de duas frotas por vez.
```
aws gamelift describe-fleet-utilization \
--limit 2
```
Resultado:
```
{
"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 uma segunda vez, passando o valor `NextToken` como argumento para o parâmetro `--next-token` a fim de visualizar os próximos dois resultados.
```
aws gamelift describe-fleet-utilization \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2
```
Repita até que a resposta não inclua mais um valor `NextToken` na saída.
Para obter mais informações, consulte [Métricas do GameLift para Frotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeFleetUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-utilization.html) na *Referência de comandos da AWS CLI*.
### `describe-game-session-queues`
O código de exemplo a seguir mostra como usar `describe-game-session-queues`.
**AWS CLI**
**Visualizar filas de sessões de jogos**
O exemplo `describe-game-session-queues` a seguir recupera as propriedades de duas filas específicas.
```
aws gamelift describe-game-session-queues \
--names MegaFrogRace-NA MegaFrogRace-EU
```
Resultado:
```
{
"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 [Usando Filas de Várias Regiões](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeGameSessionQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-session-queues.html) na *Referência de comandos da AWS CLI*.
### `describe-runtime-configuration`
O código de exemplo a seguir mostra como usar `describe-runtime-configuration`.
**AWS CLI**
**Solicitar a configuração de runtime de uma frota**
O exemplo `describe-runtime-configuration` a seguir recupera detalhes sobre a configuração atual de runtime de uma frota específica.
```
aws gamelift describe-runtime-configuration \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Resultado:
```
{
"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 Múltiplos Processos em uma Frota](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html) no *Guia do desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [DescribeRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-runtime-configuration.html) na *Referência de comandos da AWS CLI*.
### `list-builds`
O código de exemplo a seguir mostra como usar `list-builds`.
**AWS CLI**
**Exemplo 1: obter uma lista de compilações personalizadas de jogos**
O exemplo `list-builds` a seguir recupera as propriedades de todas as compilações do servidor de jogos na região atual. A solicitação exemplificada ilustra como usar os parâmetros de paginação, `Limit` e `NextToken`, para recuperar os resultados em conjuntos sequenciais. O primeiro comando recupera as duas primeiras compilações. Como há mais de dois disponíveis, a resposta contém um `NextToken` para indicar que há mais resultados disponíveis.
```
aws gamelift list-builds \
--limit 2
```
Resultado:
```
{
"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, é possível chamar o comando novamente com o parâmetro `--next-token` da seguinte forma a fim de visualizar as duas próximas compilações.
```
aws gamelift list-builds \
--limit 2
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=
```
Repita até que a resposta não inclua um `NextToken` valor.
**Exemplo 2: obter uma lista de compilações personalizadas de jogos com status de falha**
O exemplo `list-builds` a seguir recupera as propriedades de todas as compilações de servidores de jogos na região atual que têm o status FALHA.
```
aws gamelift list-builds \
--status FAILED
```
Resultado:
```
{
"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 ver detalhes da API, consulte [ListBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-builds.html) na *Referência de comandos da AWS CLI*.
### `list-fleets`
O código de exemplo a seguir mostra como usar `list-fleets`.
**AWS CLI**
**Exemplo 1: obter uma lista de todas as frotas em uma região**
O exemplo `list-fleets` a seguir exibe as IDs de frota de todas as frotas da região atual. Este exemplo usa parâmetros de paginação para recuperar duas IDs de frota por vez. A resposta inclui um `next-token` atributo, que indica que há mais resultados a serem recuperados.
```
aws gamelift list-fleets \
--limit 2
```
Resultado:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
],
"NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE="
}
```
É possível passar o valor `NextToken` da resposta anterior no próximo comando, como demonstrado aqui, para obter os próximos dois resultados.
```
aws gamelift list-fleets \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=
```
**Exemplo 2: obter uma lista de todas as frotas em uma região com uma compilação ou um script específicos**
O exemplo `list-builds` a seguir recupera as IDs das frotas implantadas com a compilação específica do jogo. Se estiver trabalhando com servidores Realtime, é possível fornecer uma ID de script em vez de uma ID de compilação. Como este exemplo não especifica o parâmetro de limite, os resultados podem incluir até 16 IDs de frota.
```
aws gamelift list-fleets \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Resultado:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444"
]
}
```
+ Para ver detalhes da API, consulte [ListFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-fleets.html) na *Referência de comandos da AWS CLI*.
### `request-upload-credentials`
O código de exemplo a seguir mostra como usar `request-upload-credentials`.
**AWS CLI**
**Atualizar as credenciais de acesso para fazer upload de uma compilação**
O exemplo `create-build` a seguir obtém credenciais de acesso novas e válidas para carregar um arquivo de compilação do GameLift em um local do Amazon S3. As credenciais têm uma vida útil limitada. Obtém-se a ID de compilação da resposta à solicitação `CreateBuild` original.
```
aws gamelift request-upload-credentials \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Resultado:
```
{
"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 para o GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) no Guia do desenvolvedor do Amazon *GameLift*.
+ Para ver detalhes da API, consulte [RequestUploadCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/request-upload-credentials.html) na *Referência de comandos da AWS CLI*.
### `start-fleet-actions`
O código de exemplo a seguir mostra como usar `start-fleet-actions`.
**AWS CLI**
**Reiniciar a atividade de ajuste de escala automática da frota**
O exemplo `start-fleet-actions` a seguir retoma o uso de todas as políticas de ajuste de escala definidas para a frota específica, mas que foram interrompidas pelas chamadas ``stop-fleet-actions``. Após o início, as políticas de ajuste de escala começam imediatamente a rastrear suas respectivas métricas.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [StartFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/start-fleet-actions.html) na *Referência de comandos da AWS CLI*.
### `stop-fleet-actions`
O código de exemplo a seguir mostra como usar `stop-fleet-actions`.
**AWS CLI**
**Interromper atividade de ajuste de escala automática de uma frota**
O exemplo `stop-fleet-actions` a seguir interrompe o uso de todas as políticas de ajuste de escala definidas para a frota específica. Depois que as políticas são suspensas, a capacidade da frota permanece com a 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 \
--actions AUTO_SCALING
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [StopFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/stop-fleet-actions.html) na *Referência de comandos da AWS CLI*.
### `update-build`
O código de exemplo a seguir mostra como usar `update-build`.
**AWS CLI**
**Atualizar uma compilação personalizada do jogo**
O exemplo `update-build` a seguir altera as informações de nome e versão associadas a um recurso de compilação específico. O objeto de compilação retornado verifica se as alterações foram feitas com êxito.
```
aws gamelift update-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--name MegaFrogRaceServer.NA.east \
--build-version 12345.east
```
Resultado:
```
{
"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](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-update-build-files) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [UpdateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-build.html) na *Referência de comandos da AWS CLI*.
### `update-game-session-queue`
O código de exemplo a seguir mostra como usar `update-game-session-queue`.
**AWS CLI**
**Atualizar a configuração da fila de uma sessão de jogo**
O exemplo `update-game-session-queue` 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 \
--destinations file://destinations.json \
--player-latency-policies file://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}
]
}
```
Resultado:
```
{
"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 [Usando Filas de Várias Regiões](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) no *Guia do Desenvolvedor do Amazon GameLift*.
+ Para ver detalhes da API, consulte [UpdateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-game-session-queue.html) na *Referência de comandos da AWS CLI*.
### `upload-build`
O código de exemplo a seguir mostra como usar `upload-build`.
**AWS CLI**
**Exemplo 1: fazer upload de uma compilação de servidor de jogos do Linux**
O exemplo `upload-build` a seguir faz upload de arquivos de compilação do servidor de jogos do Linux de um diretório de arquivos para o serviço GameLift e cria um recurso de compilação.
```
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
```
Resultado:
```
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: fazer upload de uma versão de servidor de jogos do Windows**
O exemplo `upload-build` a seguir faz upload de arquivos de compilação do servidor de jogos do Windows de um diretório para o serviço GameLift e cria um registro de compilação.
```
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
```
Resultado:
```
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 para o GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) no Guia do desenvolvedor do Amazon *GameLift*.
+ Para ver detalhes da API, consulte [UploadBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html) na *Referência de comandos da AWS CLI*.