Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Esempi di Amazon GameLift Servers che utilizzano AWS CLI
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con Amazon GameLift Servers.
Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-build`
Il seguente esempio di codice mostra come usare`create-build`.
**AWS CLI**
**Esempio 1: come creare una build del gioco da file in un bucket S3**
L’esempio `create-build` seguente crea una risorsa build personalizzata del gioco. Utilizza file compressi archiviati in una posizione S3 in un AWS account che controlli tu. Questo esempio presuppone che tu abbia già creato un ruolo IAM che GameLift autorizza Amazon ad accedere alla posizione S3. Poiché la richiesta non specifica un sistema operativo, per impostazione predefinita la nuova risorsa build è WINDOWS\$12012.
```
aws gamelift create-build \
--storage-location file://storage-loc.json \
--name MegaFrogRaceServer.NA \
--build-version 12345.678
```
Contenuto di `storage-loc.json`:
```
{
"Bucket":"MegaFrogRaceServer_NA_build_files"
"Key":"MegaFrogRaceServer_build_123.zip"
"RoleArn":"arn:aws:iam::123456789012:role/gamelift"
}
```
Output:
```
{
"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"
}
}
```
**Esempio 2: creare una risorsa per la creazione di un gioco su cui caricare manualmente i file su GameLift**
L’esempio `create-build` seguente crea una nuova risorsa build. Inoltre, ottiene una posizione di archiviazione e credenziali temporanee che ti consentono di caricare manualmente la build del gioco nella GameLift posizione in Amazon S3. Dopo aver caricato correttamente la build, il GameLift servizio convalida la build e aggiorna lo stato della nuova build.
```
aws gamelift create-build \
--name MegaFrogRaceServer.NA \
--build-version 12345.678 \
--operating-system AMAZON_LINUX
```
Output:
```
{
"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=="
}
}
```
Per ulteriori informazioni, consulta [Caricare una build di server personalizzata GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [CreateBuild AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-build.html)*Command Reference*.
### `create-fleet`
Il seguente esempio di codice mostra come utilizzare`create-fleet`.
**AWS CLI**
**Esempio 1: come creare un parco istanze Linux di base**
L’esempio `create-fleet` seguente crea un parco istanze Linux on demand con configurazione minima per ospitare una build personalizzata del server. Puoi completare la configurazione utilizzando `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}]'
```
Output:
```
{
"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"
}
}
```
**Esempio 2: come creare un parco istanze Windows di base**
L’esempio `create-fleet` seguente crea un parco istanze spot Windows con configurazione minima per ospitare una build personalizzata del server. Puoi completare la configurazione utilizzando `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}]'
```
Output:
```
{
"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"
}
}
```
**Esempio 3: come creare un parco istanze con configurazione completa**
L’esempio `create-fleet` seguente crea un parco istanze spot Windows per una build personalizzata del server, con le impostazioni di configurazione più comunemente utilizzate.
```
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'
```
Contenuto di `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}]
```
Output:
```
{
"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"
}
}
}
```
**Esempio 4: come creare un parco istanze server in tempo reale**
L'`create-fleet`esempio seguente crea una flotta di istanze Spot con uno script di configurazione in tempo reale che è stato caricato su Amazon. GameLift Tutti i server in tempo reale vengono implementati su computer Linux. Ai fini di questo esempio, presupponiamo che lo script in tempo reale caricato includa più file di script, con la funzione `Init()` inclusa nel file di script denominato `MainScript.js`. Come mostrato, questo file viene identificato come script di avvio nella configurazione del 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}]'
```
Output:
```
{
"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"
}
}
```
+ Per i dettagli sull'API, consulta *AWS CLI Command [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-fleet.html)Reference*.
### `create-game-session-queue`
Il seguente esempio di codice mostra come utilizzare`create-game-session-queue`.
**AWS CLI**
**Esempio 1: come configurare una coda ordinata di sessioni di gioco**
L’esempio `create-game-session-queue` seguente crea una nuova coda di sessioni di gioco con destinazioni in due Regioni. Configura anche la coda in modo da impostare il timeout delle richieste delle sessioni di gioco dopo un’attesa di 10 minuti per l’assegnazione. Poiché non sono state definite politiche di latenza, GameLift tenta di posizionare tutte le sessioni di gioco con la prima destinazione elencata.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--timeout-in-seconds 600
```
Contenuto di `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" }
]
}
```
Output:
```
{
"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"}
]
}
]
}
```
**Esempio 2: come configurare una coda di sessioni di gioco con policy di latenza per i giocatori**
L’esempio seguente `create-game-session-queue`esempio seguente crea una nuova coda di sessioni di gioco con policy di latenza per due giocatori. La prima policy stabilisce un limite di latenza di 100 ms, che viene applicato durante il primo minuto di un tentativo di assegnazione della sessione di gioco. La seconda policy aumenta il limite di latenza a 200 ms fino al timeout della richiesta di assegnazione, che avviene a 3 minuti.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json \
--timeout-in-seconds 180
```
Contenuto di `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" }
]
}
```
Contenuto di `latency-policies.json`:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60}
]
}
```
Output:
```
{
"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"}
],
}
}
```
Per ulteriori informazioni, consulta [Create a Queue](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html#queues-creating-cli) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [CreateGameSessionQueue AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session-queue.html)*Command Reference.*
### `delete-build`
Il seguente esempio di codice mostra come utilizzare`delete-build`.
**AWS CLI**
**Come eliminare una build personalizzata del gioco**
L'`delete-build`esempio seguente rimuove una build dal tuo GameLift account Amazon. Una volta eliminata, la build non può più essere utilizzata per creare nuovi parchi istanze. Questa operazione non può essere annullata.
```
aws gamelift delete-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DeleteBuild AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-build.html)*Command Reference*.
### `delete-fleet`
Il seguente esempio di codice mostra come utilizzare`delete-fleet`.
**AWS CLI**
**Come eliminare un parco istanze non più in uso**
L’esempio `delete-fleet` seguente rimuove un parco che è stato ridotto a zero istanze. Se la capacità del parco è maggiore di zero, la richiesta ha esito negativo e viene restituito un errore HTTP 400.
```
aws gamelift delete-fleet \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Manage GameLift Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-editing.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [DeleteFleet AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-fleet.html)*Command Reference.*
### `delete-game-session-queue`
Il seguente esempio di codice mostra come utilizzare`delete-game-session-queue`.
**AWS CLI**
**Come eliminare una coda di sessioni di gioco**
L’esempio `delete-game-session-queue` seguente elimina una coda di sessioni di gioco specificata.
```
aws gamelift delete-game-session-queue \
--name MegaFrogRace-NA
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DeleteGameSessionQueue AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-game-session-queue.html)*Command Reference*.
### `describe-build`
Il seguente esempio di codice mostra come utilizzare`describe-build`.
**AWS CLI**
**Come ottenere informazioni su una build personalizzata del gioco**
L’esempio `describe-build` seguente recupera le proprietà di una risorsa build del server di gioco.
```
aws gamelift describe-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Output:
```
{
"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"
}
}
```
Per ulteriori informazioni, consulta [Caricare una build di server personalizzata GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-builds) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [DescribeBuild AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-build.html)*Command Reference*.
### `describe-ec2-instance-limits`
Il seguente esempio di codice mostra come utilizzare`describe-ec2-instance-limits`.
**AWS CLI**
**Come recuperare le restrizioni dei servizi per un tipo di istanza EC2**
L’esempio `describe-ec2-instance-limits` seguente mostra il numero massimo di istanze consentite e di istanze attualmente in uso per il tipo di istanza EC2 specificato nella Regione corrente. Il risultato indica che vengono utilizzate solo cinque delle venti istanze consentite.
```
aws gamelift describe-ec2-instance-limits \
--ec2-instance-type m5.large
```
Output:
```
{
"EC2InstanceLimits": [
{
"EC2InstanceType": ""m5.large",
"CurrentInstances": 5,
"InstanceLimit": 20
}
]
}
```
Per ulteriori informazioni, consulta [Choose Computing Resources](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [DescribeEc2 InstanceLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-ec2-instance-limits.html) in *AWS CLI Command Reference*.
### `describe-fleet-attributes`
Il seguente esempio di codice mostra come utilizzare`describe-fleet-attributes`.
**AWS CLI**
**Esempio 1: come visualizzare gli attributi di un elenco di parchi istanze**
L’esempio `describe-fleet-attributes` seguente recupera gli attributi di due parchi specificati. Come mostrato, i parchi richiesti vengono implementati con la stessa build, uno per le istanze on demand e uno per le istanze spot, con alcune differenze di configurazione minori.
```
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
```
Output:
```
{
"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"
}
}
]
}
```
**Esempio 2: come richiedere gli attributi per tutti i parchi istanze**
L’esempio `describe-fleet-attributes` seguente restituisce gli attributi di tutti i parchi con qualsiasi stato. Questo esempio mostra l’utilizzo dei parametri di paginazione per restituire un parco per volta.
```
aws gamelift describe-fleet-attributes \
--limit 1
```
Output:
```
{
"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"
}
```
L’output include un valore `NextToken` che puoi utilizzare quando chiami il comando una seconda volta. Passa il valore al parametro `--next-token` per specificare dove recuperare l’output. Il comando seguente restituisce il secondo risultato nell’output.
```
aws gamelift describe-fleet-attributes \
--limit 1 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1
```
Ripeti il comando finché la risposta non include un valore `NextToken`.
Per ulteriori informazioni, consulta [Configurazione delle GameLift flotte](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [DescribeFleetAttributes AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-attributes.html)*Command Reference.*
### `describe-fleet-capacity`
Il seguente esempio di codice mostra come utilizzare`describe-fleet-capacity`.
**AWS CLI**
**Come visualizzare lo stato della capacità per un elenco di parchi istanze**
L’esempio `describe-fleet-capacity` seguente recupera la capacità corrente per due parchi specificati.
```
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
```
Output:
```
{
"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
}
}
]
}
```
Per ulteriori informazioni, consulta [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [DescribeFleetCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-capacity.html)Reference*.
### `describe-fleet-events`
Il seguente esempio di codice mostra come utilizzare`describe-fleet-events`.
**AWS CLI**
**Come richiedere informazioni sugli eventi per un intervallo di tempo specificato**
L'`describe-fleet-events`esempio seguente visualizza i dettagli di tutti gli eventi relativi al parco veicoli che si sono verificati durante l'intervallo di tempo specificato.
```
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
```
Output:
```
{
"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"
}
```
Per ulteriori informazioni, consulta [Debug GameLift Fleet Issues](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [DescribeFleetEvents AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-events.html)*Command Reference.*
### `describe-fleet-port-settings`
Il seguente esempio di codice mostra come utilizzare`describe-fleet-port-settings`.
**AWS CLI**
**Come visualizzare le autorizzazione di connessione in entrata per un parco istanze**
L’esempio `describe-fleet-port-settings` seguente recupera le impostazioni di connessione per un parco specificato.
```
aws gamelift describe-fleet-port-settings \
--fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Output:
```
{
"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"
}
]
}
```
Per ulteriori informazioni, consulta [Configurazione delle GameLift flotte](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [DescribeFleetPortSettings AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-port-settings.html)*Command Reference.*
### `describe-fleet-utilization`
Il seguente esempio di codice mostra come utilizzare`describe-fleet-utilization`.
**AWS CLI**
**Esempio 1: come visualizzare i dati di utilizzo per un elenco di parchi istanze**
L’esempio `describe-fleet-utilization` seguente recupera le informazioni sull’utilizzo corrente per un parco specificato.
```
aws gamelift describe-fleet-utilization \
--fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Output:
```
{
"FleetUtilization": [
{
"FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"ActiveServerProcessCount": 100,
"ActiveGameSessionCount": 62,
"CurrentPlayerSessionCount": 329,
"MaximumPlayerSessionCount": 1000
}
]
}
```
**Esempio 2: come richiedere i dati di utilizzo per tutti i parchi istanze**
L’esempio `describe-fleet-utilization` seguente restituisce i dati di utilizzo per tutti i parchi con qualsiasi stato. Questo esempio utilizza i parametri di paginazione per restituire i dati per due parchi per volta.
```
aws gamelift describe-fleet-utilization \
--limit 2
```
Output:
```
{
"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"
}
```
Chiama il comando una seconda volta, passando il valore `NextToken` come argomento al parametro `--next-token` per visualizzare i due risultati successivi.
```
aws gamelift describe-fleet-utilization \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2
```
Ripeti il comando finché la risposta non include più un valore `NextToken` nell’output.
Per ulteriori informazioni, consulta [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [DescribeFleetUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-utilization.html)Reference*.
### `describe-game-session-queues`
Il seguente esempio di codice mostra come utilizzare`describe-game-session-queues`.
**AWS CLI**
**Come visualizzare code di sessioni di gioco**
L’esempio `describe-game-session-queues` seguente recupera le proprietà per due code specificate.
```
aws gamelift describe-game-session-queues \
--names MegaFrogRace-NA MegaFrogRace-EU
```
Output:
```
{
"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"
}
]
}
```
Per ulteriori informazioni, consulta [Using Multi-Region Queues](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [DescribeGameSessionQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-session-queues.html)Reference*.
### `describe-runtime-configuration`
Il seguente esempio di codice mostra come utilizzare`describe-runtime-configuration`.
**AWS CLI**
**Come richiedere la configurazione del runtime per un parco istanze**
L’esempio `describe-runtime-configuration` seguente recupera i dettagli sulla configurazione del runtime corrente per un parco specificato.
```
aws gamelift describe-runtime-configuration \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Output:
```
{
"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
}
}
```
Per ulteriori informazioni, consulta [Esegui più processi su una flotta](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [DescribeRuntimeConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-runtime-configuration.html)*Command Reference*.
### `list-builds`
Il seguente esempio di codice mostra come utilizzare`list-builds`.
**AWS CLI**
**Esempio 1: come ottenere un elenco di build personalizzate del gioco**
L’esempio `list-builds` seguente recupera le proprietà per tutte le build del server di gioco nella Regione corrente. La richiesta di esempio mostra come utilizzare i parametri di paginazione `Limit` e `NextToken` per recuperare i risultati sotto forma di serie sequenziali. Il primo comando recupera le prime due build. Poiché le build sono più di due, la risposta include un valore `NextToken` per indicare che sono disponibili più risultati.
```
aws gamelift list-builds \
--limit 2
```
Output:
```
{
"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="
}
```
Puoi quindi chiamare di nuovo il comando con il parametro `--next-token` nel modo seguente per visualizzare le due build successive.
```
aws gamelift list-builds \
--limit 2
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=
```
Ripeti il comando finché la risposta non include un valore `NextToken`.
**Esempio 2: come ottenere un elenco di build personalizzate del gioco con stato di errore**
L’esempio `list-builds` seguente recupera le proprietà per tutte le build del server di gioco con stato FAILED nella Regione corrente.
```
aws gamelift list-builds \
--status FAILED
```
Output:
```
{
"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"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListBuilds AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-builds.html)*Command Reference*.
### `list-fleets`
Il seguente esempio di codice mostra come utilizzare`list-fleets`.
**AWS CLI**
**Esempio 1: come ottenere un elenco di tutti i parchi istanze in una Regione**
L'`list-fleets`esempio seguente mostra la flotta IDs di tutte le flotte della regione corrente. Questo esempio utilizza i parametri di impaginazione per recuperare due flotte IDs alla volta. La risposta include un attributo `next-token`, che indica la presenza di altri risultati da recuperare.
```
aws gamelift list-fleets \
--limit 2
```
Output:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
],
"NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE="
}
```
Puoi passare il valore `NextToken` della risposta precedente nel comando successivo, come mostrato qui, per ottenere i due risultati successivi.
```
aws gamelift list-fleets \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=
```
**Esempio 2: come ottenere un elenco di tutti i parchi istanze in una Regione con una build o uno script specifico**
L'`list-builds`esempio seguente recupera le IDs flotte dispiegate con la build di gioco specificata. Se utilizzi server in tempo reale, puoi fornire un ID script al posto di un ID build. Poiché questo esempio non specifica il parametro limit, i risultati possono includere fino a 16 flotte. IDs
```
aws gamelift list-fleets \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Output:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444"
]
}
```
+ Per i dettagli sull'API, consulta [ListFleets AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-fleets.html)*Command Reference*.
### `request-upload-credentials`
Il seguente esempio di codice mostra come utilizzare`request-upload-credentials`.
**AWS CLI**
**Come aggiornare le credenziali di accesso per caricare una build**
L'`create-build`esempio seguente ottiene nuove credenziali di accesso valide per caricare un file di GameLift build in una posizione Amazon S3. Le credenziali hanno una durata limitata. Puoi ottenere l’ID build dalla risposta alla richiesta `CreateBuild` originale.
```
aws gamelift request-upload-credentials \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Output:
```
{
"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=="
}
}
```
Per ulteriori informazioni, consulta [Caricare una build di server personalizzata GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [RequestUploadCredentials AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/request-upload-credentials.html)*Command Reference*.
### `start-fleet-actions`
Il seguente esempio di codice mostra come utilizzare`start-fleet-actions`.
**AWS CLI**
**Come riavviare l’attività di dimensionamento automatico di un parco istanze**
L'`start-fleet-actions`esempio seguente riprende l'uso di tutte le politiche di scalabilità definite per il parco veicoli specificato ma che sono state interrotte chiamando`` ``. stop-fleet-actions Dopo l’avvio, le policy di dimensionamento iniziano immediatamente a monitorare le rispettive metriche.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
Questo comando non produce alcun output.
+ *Per i dettagli sull'API, consulta Command Reference. [StartFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/start-fleet-actions.html)AWS CLI *
### `stop-fleet-actions`
Il seguente esempio di codice mostra come utilizzare`stop-fleet-actions`.
**AWS CLI**
**Come arrestare l’attività di dimensionamento automatico di un parco istanze**
L’esempio `stop-fleet-actions` seguente arresta l’utilizzo di tutte le policy di dimensionamento definite per il parco specificato. Una volta sospese le policy, la capacità del parco mantiene lo stesso numero di istanze attive, se questo non viene modificato manualmente.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [StopFleetActions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/stop-fleet-actions.html)*Command Reference*.
### `update-build`
Il seguente esempio di codice mostra come utilizzare`update-build`.
**AWS CLI**
**Come aggiornare una build personalizzata del gioco**
L’esempio `update-build` seguente modifica le informazioni sul nome e sulla versione associate a una risorsa build specificata. L’oggetto build restituito verifica che le modifiche siano state apportate correttamente.
```
aws gamelift update-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--name MegaFrogRaceServer.NA.east \
--build-version 12345.east
```
Output:
```
{
"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"
}
}
```
Per ulteriori informazioni, consulta [Update Your Build Files](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-update-build-files) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [UpdateBuild AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-build.html)*Command Reference*.
### `update-game-session-queue`
Il seguente esempio di codice mostra come utilizzare`update-game-session-queue`.
**AWS CLI**
**Come aggiornare la configurazione di una coda di sessioni di gioco**
L’esempio `update-game-session-queue` seguente aggiunge una nuova destinazione e aggiorna le policy di latenza dei giocatori per una coda di sessioni di gioco esistente.
```
aws gamelift update-game-session-queue \
--name MegaFrogRace-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json
```
Contenuto di `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"}
]
}
```
Contenuto di `latency-policies.json`:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120}
]
}
```
Output:
```
{
"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}
]
}
}
```
Per ulteriori informazioni, consulta [Using Multi-Region Queues](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [UpdateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-game-session-queue.html)Reference*.
### `upload-build`
Il seguente esempio di codice mostra come utilizzare`upload-build`.
**AWS CLI**
**Esempio 1: come caricare una build del server di gioco Linux**
L'`upload-build`esempio seguente carica i file di build del server di gioco Linux da una directory di file al GameLift servizio e crea una risorsa di compilazione.
```
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
```
Output:
```
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
```
**Esempio 2: come caricare una build del server di gioco Windows**
L'`upload-build`esempio seguente carica i file di build del server di gioco Windows da una directory al GameLift servizio e crea un record di build.
```
aws gamelift upload-build \
--name MegaFrogRaceServer.NA \
--build-version 2.0.1 \
--build-root C:\MegaFrogRace_Server\release-na \
--operating-system WINDOWS_2012
--server-sdk-version 4.0.2
```
Output:
```
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
```
Per ulteriori informazioni, consulta [Caricare una build di server personalizzata GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) nella *Amazon GameLift Developer Guide*.
+ Per i dettagli sull'API, consulta [UploadBuild AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html)*Command Reference*.