Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de Amazon GameLift Servers que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface mediante Amazon GameLift Servers.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `create-build`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-build`.
**AWS CLI**
**Ejemplo 1: creación de una compilación de juego a partir de los archivos de un bucket de S3**
En el siguiente ejemplo de `create-build`, se crea un nuevo recurso de compilación de juego personalizado. Utiliza archivos comprimidos que se almacenan en una ubicación S3 en una AWS cuenta que usted controla. En este ejemplo, se supone que ya has creado un rol de IAM que da GameLift permiso a Amazon para acceder a la ubicación de S3. Puesto que la solicitud no especifica un sistema operativo, el nuevo recurso de compilación es WINDOWS\$12012 de manera predeterminada.
```
aws gamelift create-build \
--storage-location file://storage-loc.json \
--name MegaFrogRaceServer.NA \
--build-version 12345.678
```
Contenido de `storage-loc.json`:
```
{
"Bucket":"MegaFrogRaceServer_NA_build_files"
"Key":"MegaFrogRaceServer_build_123.zip"
"RoleArn":"arn:aws:iam::123456789012:role/gamelift"
}
```
Salida:
```
{
"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"
}
}
```
**Ejemplo 2: Crear un recurso de compilación de juegos para cargar archivos manualmente en GameLift**
En el siguiente ejemplo de `create-build`, se crea un nuevo recurso de compilación. También cuenta con una ubicación de almacenamiento y credenciales temporales que le permiten cargar manualmente la versión del juego a la GameLift ubicación de Amazon S3. Una vez que haya cargado correctamente la compilación, el GameLift servicio la validará y actualizará el estado de la nueva.
```
aws gamelift create-build \
--name MegaFrogRaceServer.NA \
--build-version 12345.678 \
--operating-system AMAZON_LINUX
```
Salida:
```
{
"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 obtener más información, consulta [Cómo subir una versión de servidor personalizada GameLift en la Guía para GameLift desarrolladores](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) *de Amazon*.
+ Para obtener más información sobre la API, consulte [CreateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-build.html)la *Referencia de AWS CLI comandos*.
### `create-fleet`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-fleet`.
**AWS CLI**
**Ejemplo 1: creación de una flota de Linux básica**
En el siguiente ejemplo de `create-fleet`, se crea una flota mínimamente configurada de instancias de Linux bajo demanda para alojar una compilación de servidor personalizada. Puede completar la configuración 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}]'
```
Salida:
```
{
"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"
}
}
```
**Ejemplo 2: creación de una flota de Windows básica**
En el siguiente ejemplo de `create-fleet`, se crea una flota mínimamente configurada de instancias de Windows de spot para alojar una compilación de servidor personalizada. Puede completar la configuración 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}]'
```
Salida:
```
{
"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"
}
}
```
**Ejemplo 3: creación de una flota completamente configurada**
En el siguiente ejemplo de `create-fleet`, se crea una flota de instancias de Windows de spot para una versión de servidor personalizada, con los ajustes de configuración más utilizados.
```
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'
```
Contenido 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}]
```
Salida:
```
{
"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"
}
}
}
```
**Ejemplo 4: creación de una flota de Servidores en tiempo real**
En el siguiente `create-fleet` ejemplo, se crea una flota de instancias puntuales con un script de configuración en tiempo real que se ha cargado en Amazon GameLift. Todos los Servidores en tiempo real se implementan en máquinas Linux. Para este ejemplo, supongamos que el script de Realtime cargado incluye varios archivos de script y que la función `Init()` se encuentra en el archivo de script llamado `MainScript.js`. Como se muestra, este archivo se identifica como el script de inicio en la configuración de tiempo de ejecución.
```
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}]'
```
Salida:
```
{
"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 obtener más información sobre la API, consulte [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-fleet.html)la *Referencia de AWS CLI comandos*.
### `create-game-session-queue`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-game-session-queue`.
**AWS CLI**
**Ejemplo 1: configuración de una cola de sesiones de juego ordenada**
En el siguiente ejemplo de `create-game-session-queue`, se crea una nueva cola de sesiones de juego con destinos en dos regiones. También configura la cola para que las sesiones de juego soliciten tiempo de espera después de esperar 10 minutos para ser colocadas. Como no hay políticas de latencia definidas, GameLift intenta colocar todas las sesiones de juego en el primer destino de la lista.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--timeout-in-seconds 600
```
Contenido 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" }
]
}
```
Salida:
```
{
"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"}
]
}
]
}
```
**Ejemplo 2: configuración de una cola de sesiones de juego con políticas de latencia de jugadores**
En el siguiente ejemplo de `create-game-session-queue`, se crea una nueva cola de sesiones de juego con políticas de latencia para dos jugadores. La primera política establece un límite de latencia de 100 ms que se aplica durante el primer minuto de un intento de ubicación de una sesión de juego. La segunda política aumenta el límite de latencia a 200 ms hasta que se agoten los tiempos de espera de la solicitud de ubicación, que es de 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
```
Contenido 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" }
]
}
```
Contenido de `latency-policies.json`:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60}
]
}
```
Salida:
```
{
"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 obtener más información, consulta [Crear una cola](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html#queues-creating-cli) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [CreateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session-queue.html)la *Referencia de AWS CLI comandos*.
### `delete-build`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-build`.
**AWS CLI**
**Para eliminar una compilación de juego personalizada**
En el siguiente `delete-build` ejemplo, se elimina una compilación de tu GameLift cuenta de Amazon. Una vez eliminada la compilación, no podrá usarla para crear nuevas flotas. Esta operación no se puede deshacer.
```
aws gamelift delete-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulta [DeleteBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-build.html)la *Referencia de AWS CLI comandos*.
### `delete-fleet`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-fleet`.
**AWS CLI**
**Para eliminar una flota que ya no está en uso**
En el siguiente ejemplo de `delete-fleet`, se elimina una flota que se ha reducido a cero instancias. Si la capacidad de la flota es superior a cero, se produce un error HTTP 400 en la solicitud.
```
aws gamelift delete-fleet \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Este comando no genera ninguna salida.
Para obtener más información, consulta [Administrar GameLift flotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-editing.html) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [DeleteFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-fleet.html)la *Referencia de AWS CLI comandos*.
### `delete-game-session-queue`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-game-session-queue`.
**AWS CLI**
**Para eliminar una cola de sesión de juego**
En el siguiente ejemplo de `delete-game-session-queue`, se elimina una cola de sesiones de juego especificada.
```
aws gamelift delete-game-session-queue \
--name MegaFrogRace-NA
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-game-session-queue.html)la *Referencia de AWS CLI comandos*.
### `describe-build`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-build`.
**AWS CLI**
**Para obtener información sobre una compilación de juego personalizada**
En el siguiente ejemplo de `describe-build`, se recuperan las propiedades de un recurso de compilación de un servidor de juegos.
```
aws gamelift describe-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"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 obtener más información, consulta [Cómo subir una versión de servidor personalizada GameLift en la Guía para GameLift desarrolladores](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-builds) *de Amazon*.
+ Para obtener más información sobre la API, consulte [DescribeBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-build.html)la *Referencia de AWS CLI comandos*.
### `describe-ec2-instance-limits`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-ec2-instance-limits`.
**AWS CLI**
**Para recuperar los límites de servicio para un tipo de instancia de EC2**
En el siguiente ejemplo de `describe-ec2-instance-limits`, se muestran las instancias máximas permitidas y las instancias actuales que se utilizan para el tipo de instancia de EC2 especificado en la región actual. El resultado indica que solo se utilizan cinco de las veinte instancias permitidas.
```
aws gamelift describe-ec2-instance-limits \
--ec2-instance-type m5.large
```
Salida:
```
{
"EC2InstanceLimits": [
{
"EC2InstanceType": ""m5.large",
"CurrentInstances": 5,
"InstanceLimit": 20
}
]
}
```
Para obtener más información, consulte [Choose Computing Resources](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte la [DescribeEcsección 2 InstanceLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-ec2-instance-limits.html) en la *Referencia de AWS CLI comandos*.
### `describe-fleet-attributes`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-fleet-attributes`.
**AWS CLI**
**Ejemplo 1: visualización de los atributos para una lista de flotas**
En el siguiente ejemplo de `describe-fleet-attributes`, se recuperan los atributos de flota para dos flotas especificadas. Como se muestra, las flotas solicitadas se implementan con la misma compilación, una para las instancias bajo demanda y otra para las instancias de spot, con algunas pequeñas diferencias de configuración.
```
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
```
Salida:
```
{
"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"
}
}
]
}
```
**Ejemplo 2: solicitud de atributos para todas las flotas**
En el siguiente `describe-fleet-attributes`, se devuelven los atributos de flota de todas las flotas con cualquier estado. En este ejemplo, se muestra el uso de parámetros de paginación para devolver una flota a la vez.
```
aws gamelift describe-fleet-attributes \
--limit 1
```
Salida:
```
{
"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"
}
```
El resultado incluye un valor de `NextToken` que puede utilizar al llamar al comando por segunda vez. Pase el valor al parámetro `--next-token` para especificar dónde recoger la salida. El siguiente comando devuelve el segundo resultado en la salida:
```
aws gamelift describe-fleet-attributes \
--limit 1 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1
```
Repita el proceso hasta que la respuesta no incluya un valor de `NextToken`.
Para obtener más información, consulte [Configuración de GameLift flotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [DescribeFleetAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-attributes.html)la *Referencia de AWS CLI comandos*.
### `describe-fleet-capacity`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-fleet-capacity`.
**AWS CLI**
**Para ver el estado de la capacidad para una lista de flotas**
En el siguiente ejemplo de `describe-fleet-capacity`, se recupera la capacidad actual para dos flotas especificadas.
```
aws gamelift describe-fleet-capacity \
--fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222
```
Salida:
```
{
"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 obtener más información, consulta [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [DescribeFleetCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-capacity.html)la *Referencia de AWS CLI comandos*.
### `describe-fleet-events`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-fleet-events`.
**AWS CLI**
**Para solicitar eventos durante un período de tiempo específico**
En el siguiente ejemplo de `describe-fleet-events`, se muestran los detalles de todos los eventos relacionados con la flota que se produjeron durante el período de tiempo 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
```
Salida:
```
{
"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 obtener más información, consulta [Debug GameLift Fleet Issues](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [DescribeFleetEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-events.html)la *Referencia de AWS CLI comandos*.
### `describe-fleet-port-settings`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-fleet-port-settings`.
**AWS CLI**
**Para ver los permisos de conexión de entrada para una flota**
En el siguiente ejemplo de `describe-fleet-port-settings`, se recupera la configuración de conexión para una flota especificada.
```
aws gamelift describe-fleet-port-settings \
--fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"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 obtener más información, consulte [Configuración de GameLift flotas](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [DescribeFleetPortSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-port-settings.html)la *Referencia de AWS CLI comandos*.
### `describe-fleet-utilization`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-fleet-utilization`.
**AWS CLI**
**Ejemplo 1: visualización de los datos de uso de una lista de flotas**
En el siguiente ejemplo de `describe-fleet-utilization`, se recupera la información de uso actual para una flota especificada.
```
aws gamelift describe-fleet-utilization \
--fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"FleetUtilization": [
{
"FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"ActiveServerProcessCount": 100,
"ActiveGameSessionCount": 62,
"CurrentPlayerSessionCount": 329,
"MaximumPlayerSessionCount": 1000
}
]
}
```
**Ejemplo 2: solicitud de los datos de uso para todas las flotas**
En el siguiente `describe-fleet-utilization`, se devuelven los datos de uso de la flota de todas las flotas con cualquier estado. En este ejemplo, se utilizan parámetros de paginación para devolver datos de dos flotas a la vez.
```
aws gamelift describe-fleet-utilization \
--limit 2
```
Salida:
```
{
"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"
}
```
Llame al comando por segunda vez y pase el valor de `NextToken` como argumento al parámetro `--next-token` para ver los dos siguientes resultados.
```
aws gamelift describe-fleet-utilization \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2
```
Repita el proceso hasta que la respuesta deje de incluir un valor `NextToken` en la salida.
Para obtener más información, consulta [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [DescribeFleetUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-utilization.html)la *Referencia de AWS CLI comandos*.
### `describe-game-session-queues`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-game-session-queues`.
**AWS CLI**
**Para ver las colas de sesiones de juego**
En el siguiente ejemplo de `describe-game-session-queues`, se recuperan las propiedades de dos colas especificadas.
```
aws gamelift describe-game-session-queues \
--names MegaFrogRace-NA MegaFrogRace-EU
```
Salida:
```
{
"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 obtener más información, consulte [Uso de colas multirregionales](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) en la Guía para * GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte la Referencia [DescribeGameSessionQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-session-queues.html)de *AWS CLI comandos*.
### `describe-runtime-configuration`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-runtime-configuration`.
**AWS CLI**
**Para solicitar la configuración de tiempo de ejecución para una flota**
En el siguiente ejemplo de `describe-runtime-configuration`, se recuperan detalles sobre la configuración actual de tiempo de ejecución para una flota específica.
```
aws gamelift describe-runtime-configuration \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"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 obtener más información, consulte [Ejecutar varios procesos en una flota](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [DescribeRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-runtime-configuration.html)la *Referencia de AWS CLI comandos*.
### `list-builds`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-builds`.
**AWS CLI**
**Ejemplo 1: obtención de una lista de compilaciones de juegos personalizadas**
En el siguiente ejemplo de `list-builds`, se recuperan las propiedades de todas las versiones de servidores de juegos de la región actual. La solicitud de ejemplo muestra cómo utilizar los parámetros de paginación, `Limit` y `NextToken`, para recuperar los resultados en conjuntos secuenciales. El primer comando recupera las dos primeras compilaciones. Como hay más de dos disponibles, la respuesta incluye un `NextToken` para indicar que hay más resultados disponibles.
```
aws gamelift list-builds \
--limit 2
```
Salida:
```
{
"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="
}
```
A continuación, puede volver a llamar al comando con el parámetro `--next-token` de la siguiente manera para ver las dos compilaciones siguientes.
```
aws gamelift list-builds \
--limit 2
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=
```
Repita el proceso hasta que la respuesta no incluya un valor de `NextToken`.
**Ejemplo 2: obtención de una lista de compilaciones de juegos personalizadas en estado de error**
En el siguiente ejemplo de `list-builds`, se recuperan las propiedades de todas las compilaciones de servidores de juegos de la región actual que actualmente tienen el estado FAILED.
```
aws gamelift list-builds \
--status FAILED
```
Salida:
```
{
"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 obtener más información sobre la API, consulte [ListBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-builds.html)la *Referencia de AWS CLI comandos*.
### `list-fleets`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-fleets`.
**AWS CLI**
**Ejemplo 1: obtención de una lista de todas las flotas de una región**
En el siguiente `list-fleets` ejemplo, se muestra la flota IDs de todas las flotas de la región actual. En este ejemplo, se utilizan parámetros de paginación para recuperar dos flotas IDs a la vez. La respuesta incluye un atributo `next-token`, que indica que hay más resultados que recuperar.
```
aws gamelift list-fleets \
--limit 2
```
Salida:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
],
"NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE="
}
```
Puede pasar el valor `NextToken` de la respuesta anterior al siguiente comando, como se muestra aquí, para obtener los siguientes dos resultados.
```
aws gamelift list-fleets \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=
```
**Ejemplo 2: obtención de una lista de todas las flotas de una región con un script o una compilación específicos**
En el siguiente `list-builds` ejemplo, se recuperan IDs las flotas que se han desplegado con la versión de juego especificada. Si trabaja con Servidores en tiempo real, puede proporcionar un ID de script en lugar de un ID de compilación. Como en este ejemplo no se especifica el parámetro límite, los resultados pueden incluir hasta 16 flotas. IDs
```
aws gamelift list-fleets \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444"
]
}
```
+ Para obtener más información sobre la API, consulte [ListFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-fleets.html)la *Referencia de AWS CLI comandos*.
### `request-upload-credentials`
En el siguiente ejemplo de código, se muestra cómo utilizar `request-upload-credentials`.
**AWS CLI**
**Para actualizar las credenciales de acceso para cargar una compilación**
El siguiente `create-build` ejemplo obtiene credenciales de acceso nuevas y válidas para cargar un archivo de GameLift compilación en una ubicación de Amazon S3. Las credenciales tienen una vida útil limitada. El ID de compilación se obtiene de la respuesta a la solicitud de `CreateBuild` original.
```
aws gamelift request-upload-credentials \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"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 obtener más información, consulta [Cómo subir una versión de servidor personalizada GameLift en la Guía para GameLift desarrolladores](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) *de Amazon*.
+ Para obtener más información sobre la API, consulte [RequestUploadCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/request-upload-credentials.html)la *Referencia de AWS CLI comandos*.
### `start-fleet-actions`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-fleet-actions`.
**AWS CLI**
**Para reiniciar la actividad de escalado automático de la flota**
En el siguiente `start-fleet-actions` ejemplo, se reanuda el uso de todas las políticas de escalado definidas para la flota especificada, pero que se detuvieron al llamar stop-fleet-actions a ````. Tras empezar, las políticas de escalado comienzan de inmediato a realizar un seguimiento de sus métricas respectivas.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
Este comando no genera ninguna salida.
+ *Para obtener más información sobre la API, consulte la Referencia de comandos. [StartFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/start-fleet-actions.html)AWS CLI *
### `stop-fleet-actions`
En el siguiente ejemplo de código, se muestra cómo utilizar `stop-fleet-actions`.
**AWS CLI**
**Para detener la actividad de escalado automático de una flota**
En el siguiente ejemplo de `stop-fleet-actions`, se detiene el uso de todas las políticas de escalado definidas para la flota especificada. Una vez suspendidas las políticas, la capacidad de la flota permanece con el mismo número de instancias activas, a menos que lo ajuste manualmente.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [StopFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/stop-fleet-actions.html)la *Referencia de AWS CLI comandos*.
### `update-build`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-build`.
**AWS CLI**
**Para actualizar una compilación de juego personalizada**
En el siguiente ejemplo de `update-build`, se cambia el nombre y la información de versión asociada a un recurso de compilación especificado. El objeto de compilación devuelto comprueba que los cambios se hayan realizado correctamente.
```
aws gamelift update-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--name MegaFrogRaceServer.NA.east \
--build-version 12345.east
```
Salida:
```
{
"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 obtener más información, consulta [Actualizar tus archivos de compilación](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-update-build-files) en la *Guía para GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte [UpdateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-build.html)la *Referencia de AWS CLI comandos*.
### `update-game-session-queue`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-game-session-queue`.
**AWS CLI**
**Para actualizar una configuración de cola de sesión de juego**
En el siguiente ejemplo de `update-game-session-queue`, se agrega un nuevo destino y se actualizan las políticas de latencia de los jugadores para una cola de sesiones de juego existente.
```
aws gamelift update-game-session-queue \
--name MegaFrogRace-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json
```
Contenido 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"}
]
}
```
Contenido de `latency-policies.json`:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120}
]
}
```
Salida:
```
{
"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 obtener más información, consulte [Uso de colas multirregionales](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) en la Guía para * GameLift desarrolladores de Amazon*.
+ Para obtener más información sobre la API, consulte la Referencia [UpdateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-game-session-queue.html)de *AWS CLI comandos*.
### `upload-build`
En el siguiente ejemplo de código, se muestra cómo utilizar `upload-build`.
**AWS CLI**
**Ejemplo 1: carga de una compilación de servidor de juegos de Linux**
En el siguiente `upload-build` ejemplo, se cargan los archivos de compilación del servidor de juegos Linux desde un directorio de archivos al GameLift servicio y se crea un recurso de compilación.
```
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
```
Salida:
```
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
```
**Ejemplo 2: carga de una compilación de servidor de juegos de Windows**
En el siguiente `upload-build` ejemplo, se cargan los archivos de compilación del servidor de juegos de Windows desde un directorio al GameLift servicio y se crea un registro de compilación.
```
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
```
Salida:
```
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 obtener más información, consulta [Cómo subir una versión de servidor personalizada GameLift en la Guía para GameLift desarrolladores](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) *de Amazon*.
+ Para obtener más información sobre la API, consulte [UploadBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html)la *Referencia de AWS CLI comandos*.