Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Beispiele für GameLift Amazon-Server mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon GameLift Servers Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-build`
Das folgende Codebeispiel zeigt, wie Sie`create-build`.
**AWS CLI**
**Beispiel 1: So erstellen Sie einen Spiele-Build aus Dateien in einem S3-Bucket**
Im folgenden Beispiel für `create-build` wird eine benutzerdefinierte Spiele-Build-Ressource erstellt. Es verwendet komprimierte Dateien, die an einem S3-Speicherort in einem AWS Konto gespeichert sind, das Sie kontrollieren. In diesem Beispiel wird vorausgesetzt, dass Sie bereits eine IAM-Rolle erstellt haben, die Amazon die GameLift Erlaubnis erteilt, auf den S3-Standort zuzugreifen. Da die Anfrage kein Betriebssystem spezifiziert, ist die neue Build-Ressource standardmäßig WINDOWS\$12012.
```
aws gamelift create-build \
--storage-location file://storage-loc.json \
--name MegaFrogRaceServer.NA \
--build-version 12345.678
```
Inhalt von `storage-loc.json`:
```
{
"Bucket":"MegaFrogRaceServer_NA_build_files"
"Key":"MegaFrogRaceServer_build_123.zip"
"RoleArn":"arn:aws:iam::123456789012:role/gamelift"
}
```
Ausgabe:
```
{
"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"
}
}
```
**Beispiel 2: Um eine Spiele-Build-Ressource für das manuelle Hochladen von Dateien zu erstellen GameLift**
Im folgenden Beispiel für `create-build` wird eine neue Build-Ressource erstellt. Es erhält auch einen Speicherort und temporäre Anmeldeinformationen, mit denen Sie Ihren Spiel-Build manuell an den GameLift Speicherort in Amazon S3 hochladen können. Sobald Sie Ihren Build erfolgreich hochgeladen haben, validiert der GameLift Service den Build und aktualisiert den Status des neuen Builds.
```
aws gamelift create-build \
--name MegaFrogRaceServer.NA \
--build-version 12345.678 \
--operating-system AMAZON_LINUX
```
Ausgabe:
```
{
"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=="
}
}
```
Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [CreateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-build.html)in der *AWS CLI Befehlsreferenz*.
### `create-fleet`
Das folgende Codebeispiel zeigt die Verwendung`create-fleet`.
**AWS CLI**
**Beispiel 1: So erstellen Sie eine grundlegende Linux-Flotte**
Im folgenden Beispiel für `create-fleet` wird eine minimal konfigurierte Flotte von Linux-On-Demand-Instances erstellt, um einen benutzerdefinierten Server-Build zu hosten. Sie können die Konfiguration mit `update-fleet` abschließen.
```
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}]'
```
Ausgabe:
```
{
"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"
}
}
```
**Beispiel 2: So erstellen Sie eine grundlegende Windows-Flotte**
Im folgenden Beispiel für `create-fleet` wird eine minimal konfigurierte Flotte von Windows-Spot-Instances erstellt, um einen benutzerdefinierten Server-Build zu hosten. Sie können die Konfiguration mit `update-fleet` abschließen.
```
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}]'
```
Ausgabe:
```
{
"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"
}
}
```
**Beispiel 3: So erstellen Sie eine vollständig konfigurierte Flotte**
Im folgenden Beispiel für `create-fleet` wird eine Flotte von Windows-Spot-Instances für einen benutzerdefinierten Server-Build erstellt, wobei die am häufigsten verwendeten Konfigurationseinstellungen bereitgestellt werden.
```
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'
```
Inhalt von `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}]
```
Ausgabe:
```
{
"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"
}
}
}
```
**Beispiel 4: So erstellen Sie eine Realtime-Server-Flotte**
Im folgenden `create-fleet` Beispiel wird eine Flotte von Spot-Instances mit einem Echtzeit-Konfigurationsskript erstellt, das auf Amazon GameLift hochgeladen wurde. Alle Realtime-Server werden auf Linux-Computern bereitgestellt. Gehen Sie für dieses Beispiel davon aus, dass das hochgeladene Realtime-Skript mehrere Skriptdateien enthält, wobei sich die `Init()`-Funktion in der Skriptdatei namens `MainScript.js` befindet. Wie gezeigt, wird diese Datei in der Laufzeitkonfiguration als Startskript identifiziert.
```
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}]'
```
Ausgabe:
```
{
"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"
}
}
```
+ Einzelheiten zur API finden Sie [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-fleet.html)in der *AWS CLI Befehlsreferenz.*
### `create-game-session-queue`
Das folgende Codebeispiel zeigt die Verwendung`create-game-session-queue`.
**AWS CLI**
**Beispiel 1: So richten Sie eine geordnete Warteschlange für Spielsitzungen ein**
Im folgenden Beispiel für `create-game-session-queue` wird eine neue Warteschlange für Spielsitzungen mit Zielen in zwei Regionen erstellt. Außerdem wird die Warteschlange so konfiguriert, dass Spielsitzungsanfragen nach 10 Minuten Wartezeit auf die Platzierung ablaufen. Da keine Latenzrichtlinien definiert sind, wird GameLift versucht, alle Spielsitzungen mit dem ersten aufgelisteten Ziel zu platzieren.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--timeout-in-seconds 600
```
Inhalt von `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" }
]
}
```
Ausgabe:
```
{
"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"}
]
}
]
}
```
**Beispiel 2: So richten Sie eine Warteschlange für Spielsitzungen mit Latenzrichtlinien für Spieler ein**
Im folgenden Beispiel für `create-game-session-queue` wird eine neue Warteschlange für Spielsitzungen mit zwei Latenzrichtlinien für Spieler erstellt. Die erste Richtlinie legt eine Latenzgrenze von 100 ms fest, die während der ersten Minute eines Platzierungsversuchs für eine Spielsitzung durchgesetzt wird. Die zweite Richtlinie erhöht die Latenzgrenze auf 200 ms, bis die Platzierungsanfrage nach 3 Minuten abläuft.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json \
--timeout-in-seconds 180
```
Inhalt von `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" }
]
}
```
Inhalt von `latency-policies.json`:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60}
]
}
```
Ausgabe:
```
{
"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"}
],
}
}
```
Weitere Informationen finden Sie unter [Create a Queue](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html#queues-creating-cli) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [CreateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session-queue.html)in der *AWS CLI Befehlsreferenz*.
### `delete-build`
Das folgende Codebeispiel zeigt die Verwendung`delete-build`.
**AWS CLI**
**So löschen Sie einen benutzerdefinierten Spiele-Build**
Im folgenden `delete-build` Beispiel wird ein Build aus Ihrem GameLift Amazon-Konto entfernt. Nachdem der Build gelöscht wurde, können Sie ihn nicht mehr zum Erstellen neuer Flotten verwenden. Diese Operation kann nicht rückgängig gemacht werden.
```
aws gamelift delete-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-build.html)in der *AWS CLI Befehlsreferenz*.
### `delete-fleet`
Das folgende Codebeispiel zeigt die Verwendung`delete-fleet`.
**AWS CLI**
**So löschen Sie eine Flotte, die nicht mehr verwendet wird**
Im folgenden Beispiel für `delete-fleet` wird eine Flotte entfernt, die auf null Instances herunterskaliert wurde. Wenn die Flottenkapazität größer als Null ist, schlägt die Anfrage mit einem HTTP-400-Fehler fehl.
```
aws gamelift delete-fleet \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Manage GameLift Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-editing.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DeleteFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-fleet.html)in der *AWS CLI Befehlsreferenz.*
### `delete-game-session-queue`
Das folgende Codebeispiel zeigt die Verwendung`delete-game-session-queue`.
**AWS CLI**
**So löschen Sie eine Warteschlange für Spielsitzungen**
Im folgenden Beispiel für `delete-game-session-queue` wird eine angegebene Warteschlange für Spielsitzungen gelöscht.
```
aws gamelift delete-game-session-queue \
--name MegaFrogRace-NA
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-game-session-queue.html)in der *AWS CLI Befehlsreferenz*.
### `describe-build`
Das folgende Codebeispiel zeigt die Verwendung`describe-build`.
**AWS CLI**
**So rufen Sie Informationen zu einem benutzerdefinierten Spiele-Build ab**
Im folgenden Beispiel für `describe-build` werden Eigenschaften für eine Spieleserver-Build-Ressource abgerufen.
```
aws gamelift describe-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"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"
}
}
```
Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-builds) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-build.html)in der *AWS CLI Befehlsreferenz*.
### `describe-ec2-instance-limits`
Das folgende Codebeispiel zeigt die Verwendung`describe-ec2-instance-limits`.
**AWS CLI**
**So rufen Sie Servicelimits für einen EC2-Instance-Typ ab**
Im folgenden Beispiel für `describe-ec2-instance-limits` werden die maximal zulässigen Instances und die aktuell verwendeten Instances für den angegebenen EC2-Instance-Typ in der aktuellen Region angezeigt. Das Ergebnis zeigt, dass nur fünf der zwanzig zulässigen Instances verwendet werden.
```
aws gamelift describe-ec2-instance-limits \
--ec2-instance-type m5.large
```
Ausgabe:
```
{
"EC2InstanceLimits": [
{
"EC2InstanceType": ""m5.large",
"CurrentInstances": 5,
"InstanceLimit": 20
}
]
}
```
Weitere Informationen finden [Sie unter Choose Computing Resources](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie unter [DescribeEc2 InstanceLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-ec2-instance-limits.html) in der *AWS CLI Befehlsreferenz*.
### `describe-fleet-attributes`
Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-attributes`.
**AWS CLI**
**Beispiel 1: So zeigen Sie Attribute für eine Liste von Flotten an**
Im folgenden Beispiel für `describe-fleet-attributes` werden Flottenattribute für zwei angegebene Flotten abgerufen. Wie gezeigt, werden die angeforderten Flotten mit demselben Build bereitgestellt, eine für On-Demand-Instances und eine für Spot Instances, mit einigen geringfügigen Konfigurationsunterschieden.
```
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
```
Ausgabe:
```
{
"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"
}
}
]
}
```
**Beispiel 2: So fordern Sie Attribute für alle Flotten an**
Im folgenden Beispiel für `describe-fleet-attributes` werden Flottenattribute für alle Flotten mit beliebigem Status zurückgegeben. Dieses Beispiel veranschaulicht die Verwendung von Paginierungsparametern, um jeweils eine Flotte zurückzugeben.
```
aws gamelift describe-fleet-attributes \
--limit 1
```
Ausgabe:
```
{
"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"
}
```
Die Ausgabe enthält einen `NextToken`-Wert, den Sie verwenden können, wenn Sie den Befehl ein zweites Mal aufrufen. Übergeben Sie den Wert an den `--next-token`-Parameter, um anzugeben, wo die Ausgabe abgerufen werden soll. Mit dem folgenden Befehl wird das zweite Ergebnis in der Ausgabe zurückgegeben.
```
aws gamelift describe-fleet-attributes \
--limit 1 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1
```
Wiederholen Sie den Vorgang, bis die Antwort keinen `NextToken`-Wert umfasst.
Weitere Informationen finden Sie unter [Setting Up GameLift Flotten](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeFleetAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-attributes.html)in der *AWS CLI Befehlsreferenz.*
### `describe-fleet-capacity`
Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-capacity`.
**AWS CLI**
**So zeigen Sie den Kapazitätsstatus für eine Liste von Flotten an**
Im folgenden Beispiel für `describe-fleet-capacity` wird die aktuelle Kapazität für zwei angegebene Flotten abgerufen.
```
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
```
Ausgabe:
```
{
"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
}
}
]
}
```
Weitere Informationen finden Sie unter [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeFleetCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-capacity.html)in der *AWS CLI Befehlsreferenz.*
### `describe-fleet-events`
Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-events`.
**AWS CLI**
**So fordern Sie Ereignisse für einen bestimmten Zeitraum an**
Im folgenden `describe-fleet-events` Beispiel werden Details zu allen flottenbezogenen Ereignissen angezeigt, die während des angegebenen Zeitraums aufgetreten sind.
```
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
```
Ausgabe:
```
{
"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"
}
```
Weitere Informationen finden Sie unter [Debug GameLift Fleet Issues](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeFleetEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-events.html)in der *AWS CLI Befehlsreferenz.*
### `describe-fleet-port-settings`
Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-port-settings`.
**AWS CLI**
**So zeigen Sie eingehende Verbindungsberechtigungen für eine Flotte an**
Im folgenden Beispiel für `describe-fleet-port-settings` werden Verbindungseinstellungen für eine angegebene Flotte abgerufen.
```
aws gamelift describe-fleet-port-settings \
--fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"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"
}
]
}
```
Weitere Informationen finden Sie unter [Setting Up GameLift Flotten](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeFleetPortSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-port-settings.html)in der *AWS CLI Befehlsreferenz.*
### `describe-fleet-utilization`
Das folgende Codebeispiel zeigt die Verwendung`describe-fleet-utilization`.
**AWS CLI**
**Beispiel 1: So zeigen Sie Nutzungsdaten für eine Liste von Flotten an**
Im folgenden Beispiel für `describe-fleet-utilization` werden aktuelle Nutzungsinformationen für eine angegebene Flotte abgerufen.
```
aws gamelift describe-fleet-utilization \
--fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"FleetUtilization": [
{
"FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"ActiveServerProcessCount": 100,
"ActiveGameSessionCount": 62,
"CurrentPlayerSessionCount": 329,
"MaximumPlayerSessionCount": 1000
}
]
}
```
**Beispiel 2: So fordern Sie Nutzungsdaten für alle Flotten an**
Im folgenden Beispiel für `describe-fleet-utilization` werden Flottennutzungsdaten für alle Flotten mit beliebigem Status zurückgegeben. In diesem Beispiel werden Paginierungsparameter verwendet, um jeweils Daten für zwei Flotten zurückzugeben.
```
aws gamelift describe-fleet-utilization \
--limit 2
```
Ausgabe:
```
{
"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"
}
```
Rufen Sie den Befehl ein zweites Mal auf und übergeben Sie den `NextToken`-Wert als Argument an den `--next-token`-Parameter, um die nächsten beiden Ergebnisse anzuzeigen.
```
aws gamelift describe-fleet-utilization \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2
```
Wiederholen Sie den Vorgang, bis die Antwort keinen `NextToken`-Wert mehr in der Ausgabe enthält.
Weitere Informationen finden Sie unter [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeFleetUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-utilization.html)in der *AWS CLI Befehlsreferenz.*
### `describe-game-session-queues`
Das folgende Codebeispiel zeigt die Verwendung`describe-game-session-queues`.
**AWS CLI**
**So zeigen Sie Warteschlangen für Spielsitzungen an**
Im folgenden Beispiel für `describe-game-session-queues` werden Eigenschaften für zwei angegebene Warteschlangen abgerufen.
```
aws gamelift describe-game-session-queues \
--names MegaFrogRace-NA MegaFrogRace-EU
```
Ausgabe:
```
{
"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"
}
]
}
```
Weitere Informationen finden Sie unter [Using Multi-Region-Warteschlangen](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeGameSessionQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-session-queues.html)in der *AWS CLI Befehlsreferenz*.
### `describe-runtime-configuration`
Das folgende Codebeispiel zeigt die Verwendung`describe-runtime-configuration`.
**AWS CLI**
**So fordern Sie die Laufzeitkonfiguration für eine Flotte ab**
Im folgenden Beispiel für `describe-runtime-configuration` werden Details zur aktuellen Laufzeitkonfiguration für eine angegebene Flotte abgerufen.
```
aws gamelift describe-runtime-configuration \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"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
}
}
```
Weitere Informationen finden Sie unter [Ausführen mehrerer Prozesse auf einer Flotte](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [DescribeRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-runtime-configuration.html)in der *AWS CLI Befehlsreferenz*.
### `list-builds`
Das folgende Codebeispiel zeigt die Verwendung`list-builds`.
**AWS CLI**
**Beispiel 1: So rufen Sie eine Liste benutzerdefinierter Spiele-Builds ab**
Im folgenden Beispiel für `list-builds` werden Eigenschaften für alle Spieleserver-Builds in der aktuellen Region abgerufen. Die Beispielanfrage veranschaulicht, wie die Paginierungsparameter `Limit` und `NextToken` verwendet werden, um die Ergebnisse in sequentiellen Sätzen abzurufen. Mit dem ersten Befehl werden die ersten beiden Builds abgerufen. Da mehr als zwei verfügbar sind, enthält die Antwort ein `NextToken`, um anzuzeigen, dass mehr Ergebnisse verfügbar sind.
```
aws gamelift list-builds \
--limit 2
```
Ausgabe:
```
{
"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="
}
```
Anschließend kann der Befehl mit dem `--next-token`-Parameter wie folgt erneut aufgerufen werden, um die nächsten beiden Builds anzuzeigen.
```
aws gamelift list-builds \
--limit 2
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=
```
Wiederholen Sie den Vorgang, bis die Antwort keinen `NextToken`-Wert umfasst.
**Beispiel 2: So rufen Sie eine Liste benutzerdefinierter Spiele-Builds im Fehlerstatus ab**
Im folgenden Beispiel für `list-builds` werden Eigenschaften für alle Spieleserver-Builds in der aktuellen Region abgerufen, die derzeit den Status FAILED aufweisen.
```
aws gamelift list-builds \
--status FAILED
```
Ausgabe:
```
{
"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"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-builds.html)in der *AWS CLI Befehlsreferenz*.
### `list-fleets`
Das folgende Codebeispiel zeigt die Verwendung`list-fleets`.
**AWS CLI**
**Beispiel 1: So rufen Sie eine Liste aller Flotten in einer Region ab**
Das folgende `list-fleets` Beispiel zeigt die Flotte IDs aller Flotten in der aktuellen Region. In diesem Beispiel werden Paginierungsparameter verwendet, um zwei Flotten IDs gleichzeitig abzurufen. Die Antwort umfasst ein `next-token`-Attribut, das angibt, dass weitere Ergebnisse abgerufen werden können.
```
aws gamelift list-fleets \
--limit 2
```
Ausgabe:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
],
"NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE="
}
```
Sie können den `NextToken`-Wert aus der vorherigen Antwort im nächsten Befehl übergeben, wie hier gezeigt, um die nächsten beiden Ergebnisse abzurufen.
```
aws gamelift list-fleets \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=
```
**Beispiel 2: So rufen Sie eine Liste aller Flotten in einer Region mit einem bestimmten Build oder Skript ab**
Im folgenden `list-builds` Beispiel werden die IDs Flotten abgerufen, die mit dem angegebenen Spiel-Build bereitgestellt wurden. Wenn Sie mit Realtime-Servern arbeiten, können Sie anstelle einer Build-ID eine Skript-ID angeben. Da in diesem Beispiel der Grenzparameter nicht angegeben ist, können die Ergebnisse bis zu 16 Flotten umfassen. IDs
```
aws gamelift list-fleets \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444"
]
}
```
+ Einzelheiten zur API finden Sie [ListFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-fleets.html)unter *AWS CLI Befehlsreferenz*.
### `request-upload-credentials`
Das folgende Codebeispiel zeigt die Verwendung`request-upload-credentials`.
**AWS CLI**
**So aktualisieren Sie Anmeldeinformationen für das Hochladen eines Builds**
Im folgenden `create-build` Beispiel werden neue, gültige Zugangsdaten für das Hochladen einer GameLift Build-Datei an einen Amazon S3 S3-Speicherort abgerufen. Anmeldeinformationen haben eine begrenzte Nutzungsdauer. Sie erhalten die Build-ID aus der Antwort auf die ursprüngliche `CreateBuild`-Anfrage.
```
aws gamelift request-upload-credentials \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Ausgabe:
```
{
"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=="
}
}
```
Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [RequestUploadCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/request-upload-credentials.html)in der *AWS CLI Befehlsreferenz*.
### `start-fleet-actions`
Das folgende Codebeispiel zeigt die Verwendung`start-fleet-actions`.
**AWS CLI**
**So starten Sie die Aktivität zur automatischen Skalierung der Flotte neu**
Im folgenden `start-fleet-actions` Beispiel werden alle Skalierungsrichtlinien wieder verwendet, die für die angegebene Flotte definiert sind, aber durch den Aufruf stop-fleet-actions von ```` gestoppt wurden. Nach dem Start beginnen die Skalierungsrichtlinien sofort mit der Erfassung ihrer jeweiligen Metriken.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz. [StartFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/start-fleet-actions.html)AWS CLI *
### `stop-fleet-actions`
Das folgende Codebeispiel zeigt die Verwendung`stop-fleet-actions`.
**AWS CLI**
**So stoppen Sie die Aktivität zur automatischen Skalierung einer Flotte**
Im folgenden Beispiel für `stop-fleet-actions` wird die Verwendung aller Skalierungsrichtlinien gestoppt, die für die angegebene Flotte definiert sind. Nachdem die Richtlinien ausgesetzt wurden, bleibt die Flottenkapazität auf der aktuellen Anzahl aktiver Instances bestehen, sofern sie nicht manuell angepasst wird.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [StopFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/stop-fleet-actions.html)in der *AWS CLI Befehlsreferenz*.
### `update-build`
Das folgende Codebeispiel zeigt die Verwendung`update-build`.
**AWS CLI**
**So aktualisieren Sie einen benutzerdefinierten Spiele-Build**
Im folgenden Beispiel für `update-build` werden der Name und die Versionsinformationen geändert, die einer angegebenen Build-Ressource zugeordnet sind. Das zurückgegebene Build-Objekt bestätigt, dass die Änderungen erfolgreich vorgenommen wurden.
```
aws gamelift update-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--name MegaFrogRaceServer.NA.east \
--build-version 12345.east
```
Ausgabe:
```
{
"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"
}
}
```
Weitere Informationen finden Sie unter [Aktualisieren Ihrer Build-Dateien](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-update-build-files) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [UpdateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-build.html)in der *AWS CLI Befehlsreferenz*.
### `update-game-session-queue`
Das folgende Codebeispiel zeigt die Verwendung`update-game-session-queue`.
**AWS CLI**
**So aktualisieren Sie die Konfiguration einer Warteschlange für Spielsitzungen**
Im folgenden Beispiel für `update-game-session-queue` wird ein neues Ziel hinzugefügt und die Spielerlatenz-Richtlinien werden für eine bestehende Spielsitzungswarteschlange aktualisiert.
```
aws gamelift update-game-session-queue \
--name MegaFrogRace-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json
```
Inhalt von `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"}
]
}
```
Inhalt von `latency-policies.json`:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120}
]
}
```
Ausgabe:
```
{
"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}
]
}
}
```
Weitere Informationen finden Sie unter [Using Multi-Region-Warteschlangen](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [UpdateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-game-session-queue.html)in der *AWS CLI Befehlsreferenz*.
### `upload-build`
Das folgende Codebeispiel zeigt die Verwendung`upload-build`.
**AWS CLI**
**Beispiel 1: So laden Sie einen Linux-Spieleserver-Build hoch**
Das folgende `upload-build` Beispiel lädt Build-Dateien für Linux-Gameserver aus einem Dateiverzeichnis in den GameLift Dienst hoch und erstellt eine Build-Ressource.
```
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
```
Ausgabe:
```
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
```
**Beispiel 2: So laden Sie einen Windows-Spieleserver-Build hoch**
Im folgenden `upload-build` Beispiel werden Build-Dateien für Windows-Gameserver aus einem Verzeichnis in den GameLift Dienst hochgeladen und ein Build-Datensatz erstellt.
```
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
```
Ausgabe:
```
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
```
Weitere Informationen finden Sie unter [Hochladen eines benutzerdefinierten Server-Builds auf GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html) im *Amazon GameLift Developer Guide*.
+ Einzelheiten zur API finden Sie [UploadBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html)in der *AWS CLI Befehlsreferenz*.