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.
# Platzierungsveranstaltungen für Spielsitzungen
Amazon GameLift Serversgibt Ereignisse für jede Anfrage zur Platzierung einer Spielsitzung aus, während diese verarbeitet wird. Sie können diese Ereignisse in einem Amazon SNS SNS-Thema veröffentlichen, wie unter beschrieben[Event-Benachrichtigung für die Platzierung von Spielsitzungen einrichten](queue-notification.md). Diese Ereignisse werden auch nahezu in Echtzeit und nach bestem Wissen und Gewissen an Amazon CloudWatch Events gesendet.
Dieses Thema beschreibt die Struktur der Platzierungsveranstaltungen für Spielsitzungen und bietet ein Beispiel für jeden Ereignistyp. Weitere Informationen zum Status von Anfragen zur Platzierung von Spielsitzungen finden Sie [GameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSessionPlacement.html)in der *Amazon GameLift ServersAPI-Referenz*.
## Syntax für Platzierungsereign
Ereignisse werden als JSON-Objekte dargestellt. Die Struktur der CloudWatch Ereignisse entspricht dem Ereignismuster mit ähnlichen Feldern auf oberster Ebene und dienstspezifischen Details.
Zu den Feldern der obersten Ebene gehören die folgenden Felder (weitere Informationen finden Sie unter [Ereignismuster](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)):
version
Dieses Feld ist immer auf 0 (Null) gesetzt.
id
Eindeutige Tracking-ID für das Ereignis.
detail-type
Wert ist immer`GameLift Queue Placement Event`.
Quelle
Wert ist immer`aws.gamelift`.
Konto
Das AWS Konto, das zur Verwaltung verwendet wirdAmazon GameLift Servers.
time
Zeitstempel des Ereignisses.
Region
Die AWS Region, in der die Platzierungsanfrage bearbeitet wird. Dies ist die Region, in der sich die aktuell verwendete Warteschlange für Spielsitzungen befindet.
Ressourcen
ARN-Wert der Warteschlange für die Spielsitzung, die die Platzierungsanfrage verarbeitet.
## PlacementFulfilled
Die Platzierungsanfrage wurde erfolgreich erfüllt. Eine neue Spielsitzung wurde gestartet und für jeden Spieler, der in der Platzierungsanfrage für die Spielsitzung aufgeführt ist, wurden neue Spielersitzungen erstellt. Verbindungsinformationen für Spieler sind verfügbar.
**Syntax im Detail:**
Platzierungs-ID
Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.
port
Die Portnummer für die neue Spielsitzung.
gameSessionArn
Die ARN-ID für die neue Spielsitzung.
ipAddress
Die IP-Adresse der Spielsitzung.
DNS-Name
Die DNS-ID, die der Instanz zugewiesen wurde, auf der die neue Spielsitzung ausgeführt wird. Das Wertformat ist unterschiedlich, je nachdem, ob die Instanz, auf der die Spielsitzung ausgeführt wird, TLS-fähig ist. Wenn Spieler auf einer TLS-fähigen Flotte eine Verbindung zu einer Spielsitzung herstellen, müssen sie den DNS-Namen verwenden, nicht die IP-Adresse.
TLS-fähige Flotten:. `..amazongamelift.com`
Non-TLS-enabled Flotten:. `ec2-.compute.amazonaws.com`
startTime
Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.
endTime
Zeitstempel, der angibt, wann diese Anfrage erfüllt wurde.
gameSessionRegion
AWS Heimatregion der Flotte, die die Spielsitzung veranstaltet.
gameSessionLocation
Der Standort der Flotte, an dem die Spielsitzung läuft. Dieser Wert kann die Heimatregion der Flotte oder einen entfernten Standort angeben.
playerGatewayStatus
Der Status des Spieler-Gateways am Flottenstandort, an dem diese Spielsitzung stattfindet.
Mögliche Werte sind:
+ `ENABLED`— Das Player-Gateway ist für die Weiterleitung von Spielerverbindungen für diese Spielsitzung verfügbar.
+ `DISABLED`— Das Player-Gateway ist für diese Spielsitzung nicht verfügbar.
ComputeName
Eine beschreibende Bezeichnung für die Rechenressource, die die Spielsitzung hostet. Für EC2-Flotten ist dies die EC2-Instance-ID. Bei Container-Flotten wird jeder Spielserver-Containergruppe auf einer Flotteninstanz ein Computename zugewiesen. Für Anywhere-Flotten ist dies der benutzerdefinierte Computename.
placedPlayerSessions
Die Sammlung von Spielersitzungen, die für jeden Spieler in der Platzierungsanfrage für die Spielsitzung erstellt wurden.
### Beispiel
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementFulfilled",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"port": "6262",
"gameSessionArn": "arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/us-east-1/4444dddd-55ee-66ff-77aa-8888bbbb99cc",
"ipAddress": "98.987.98.987",
"dnsName": "ec2-12-345-67-890.us-west-2.compute.amazonaws.com",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z",
"gameSessionRegion": "us-west-2",
"playerGatewayStatus": "ENABLED",
"gameSessionLocation": "us-east-1",
"computeName": "i-1234567890abcdef0",
"placedPlayerSessions": [
{
"playerId": "player-1"
"playerSessionId": "psess-1232131232324124123123"
}
]
}
}
```
## PlacementCancelled
Die Platzierungsanfrage wurde mit einem Anruf beim GameLift Service storniert [StopGameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StopGameSessionPlacement.html).
**Detail:**
Platzierungs-ID
Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.
startTime
Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.
endTime
Zeitstempel, der angibt, wann diese Anfrage storniert wurde.
### Beispiel
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementCancelled",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```
## PlacementTimedOut
Die Platzierung der Spielsitzung wurde nicht erfolgreich abgeschlossen, bevor das Zeitlimit der Warteschlange abgelaufen ist. Die Platzierungsanfrage kann bei Bedarf erneut eingereicht werden.
**Detail:**
Platzierungs-ID
Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.
startTime
Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.
endTime
Zeitstempel, der angibt, wann diese Anfrage storniert wurde.
### Beispiel
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementTimedOut",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```
## PlacementFailed
Amazon GameLift Serverskonnte die Anfrage für die Spielsitzung nicht erfüllen. Dies wird in der Regel durch einen unerwarteten internen Fehler verursacht. Die Platzierungsanfrage kann bei Bedarf erneut eingereicht werden.
**Detail:**
Platzierungs-ID
Eine eindeutige Kennung, die der Platzierungsanfrage für die Spielsitzung zugewiesen wurde.
startTime
Zeitstempel, der angibt, wann diese Anfrage in die Warteschlange gestellt wurde.
endTime
Zeitstempel, der angibt, wann diese Anfrage fehlgeschlagen ist.
### Beispiel
```
{
"version": "0",
"id": "39c978f3-ba46-3f7c-e787-55bfcca1bd31",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "252386620677",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:252386620677:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementFailed",
"placementId": "e4a1119a-39af-45cf-a990-ef150fe0d453",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```