Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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á.
# Exemplos de GameLift servidores 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 Amazon GameLift Servers.
*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 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 função do IAM 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 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"
}
```
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 exemplo `create-build` 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 seu 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-version 12345.678 \
--operating-system AMAZON_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](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [CreateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-build.html)em *Referência de AWS CLI Comandos*.
### `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}]'
```
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: 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}]'
```
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: 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}]
```
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: criar uma frota de servidores Realtime**
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 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}]'
```
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 obter detalhes da API, consulte [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-fleet.html)em *Referência de AWS CLI Comandos*.
### `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 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 \
--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" }
]
}
```
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: 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}
]
}
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html#queues-creating-cli) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [CreateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session-queue.html)em *Referência de AWS CLI Comandos*.
### `delete-build`
O código de exemplo a seguir mostra como usar `delete-build`.
**AWS CLI**
**Excluir uma compilaçã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. 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 obter detalhes da API, consulte [DeleteBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-build.html)em *Referência de AWS CLI Comandos*.
### `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 GameLift frotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-editing.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DeleteFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-fleet.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-game-session-queue.html)em *Referência de AWS CLI Comandos*.
### `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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-builds) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-build.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"EC2InstanceLimits": [
{
"EC2InstanceType": ""m5.large",
"CurrentInstances": 5,
"InstanceLimit": 20
}
]
}
```
Para obter mais informações, consulte [Choose Computing Resources](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeEc2 InstanceLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-ec2-instance-limits.html) em *Referência de AWS CLI comandos*.
### `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
```
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: 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
```
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 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 [Configurando GameLift frotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeFleetAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-attributes.html)em *Referência de AWS CLI Comandos*.
### `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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeFleetCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-capacity.html)em *Referência de AWS CLI Comandos*.
### `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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeFleetEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-events.html)em *Referência de AWS CLI Comandos*.
### `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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeFleetPortSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-port-settings.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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
```
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 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 [GameLift Métricas para frotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeFleetUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-utilization.html)em *Referência de AWS CLI Comandos*.
### `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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeGameSessionQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-session-queues.html)em *Referência de AWS CLI Comandos*.
### `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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [DescribeRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-runtime-configuration.html)em *Referência de AWS CLI Comandos*.
### `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
```
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, é 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
```
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 obter detalhes da API, consulte [ListBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-builds.html)em *Referência de AWS CLI Comandos*.
### `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 `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 um `next-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="
}
```
É 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 `list-builds` exemplo a seguir recupera IDs as frotas implantadas com a versão de jogo especificada. Se estiver trabalhando com servidores Realtime, é possível fornecer uma ID de script em vez de uma ID de compilação. Como esse exemplo não especifica o parâmetro limite, os resultados podem incluir até 16 frotas IDs.
```
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 obter detalhes da API, consulte [ListFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-fleets.html)em *Referência de AWS CLI Comandos*.
### `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 `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. 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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [RequestUploadCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/request-upload-credentials.html)em *Referência de AWS CLI Comandos*.
### `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 `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`` ``. 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 obter detalhes da API, consulte [StartFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/start-fleet-actions.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [StopFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/stop-fleet-actions.html)em *Referência de AWS CLI Comandos*.
### `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
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-update-build-files) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [UpdateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-build.html)em *Referência de AWS CLI Comandos*.
### `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}
]
}
```
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](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [UpdateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-game-session-queue.html)em *Referência de AWS CLI Comandos*.
### `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 `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-version 2.0.1 \
--build-root ~/MegaFrogRace_Server/release-na \
--operating-system AMAZON_LINUX_2
--server-sdk-version 4.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: fazer upload de uma versã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-version 2.0.1 \
--build-root C:\MegaFrogRace_Server\release-na \
--operating-system WINDOWS_2012
--server-sdk-version 4.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](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) no *Amazon GameLift Developer Guide*.
+ Para obter detalhes da API, consulte [UploadBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html)em *Referência de AWS CLI Comandos*.