기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 게임 세션 배치 이벤트
Amazon GameLift Servers는 각 게임 세션 배치 요청이 처리될 때 해당 요청에 대해 이벤트를 내보냅니다. [게임 세션 배치의 이벤트 알림 설정](queue-notification.md)에 설명된 대로 Amazon SNS 주제에 이러한 이벤트를 게시할 수 있습니다. 또한 이러한 이벤트는 Amazon CloudWatch Events에 거의 실시간으로 전송됩니다.
이 주제에서는 게임 세션 배치 이벤트의 구조를 설명하고 각 이벤트 유형의 예를 제공합니다. 게임 세션 배치 요청의 상태에 대한 자세한 내용은 *Amazon GameLift Servers API 참조*의 [GameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSessionPlacement.html)를 참조하세요.
## 배치 이벤트 구문
이벤트는 JSON 객체로 표현됩니다. 이벤트 구조는 유사한 최상위 필드 및 서비스별 세부 정보를 포함하는 CloudWatch 이벤트 패턴을 따릅니다.
최상위 필드에는 다음이 포함됩니다(자세한 내용은 [이벤트 패턴](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) 참조).
버전
이 필드는 항상 0으로 설정됩니다.
id
이벤트의 고유 추적 식별자입니다.
detail-type
값은 항상 `GameLift Queue Placement Event`입니다.
source
값은 항상 `aws.gamelift`입니다.
계정
를 관리하는 데 사용되는 AWS 계정입니다Amazon GameLift Servers.
시간
이벤트 타임스탬프입니다.
리전
배치 요청이 처리되는 AWS 리전입니다. 사용 중인 게임 세션 대기열이 있는 리전입니다.
resources
배치 요청을 처리하는 게임 세션 대기열의 ARN 값입니다.
## PlacementFulfilled
배치 요청이 성공적으로 처리되었습니다. 새 게임 세션이 시작되었고 게임 세션 배치 요청에 나열된 각 플레이어에 대한 새 플레이어 세션이 생성되었습니다. 플레이어 연결 정보를 확인할 수 있습니다.
**상세 구문:**
placementId
게임 세션 배치 요청에 할당된 고유 식별자입니다.
포트
새 게임 세션의 포트 번호입니다.
gameSessionArn
새 게임 세션에 대한 ARN 식별자입니다.
ipAddress
게임 세션의 IP 주소입니다.
dnsName
새 게임 세션을 실행하는 인스턴스에 할당된 DNS 식별자입니다. 값 형식은 게임 세션을 실행하는 인스턴스가 TLS를 지원하는지 여부에 따라 달라집니다. TLS 지원 플릿에서 게임 세션에 연결할 때는 플레이어는 IP 주소가 아닌 DNS 이름을 사용해야 합니다.
TLS 지원 플릿: `..amazongamelift.com`.
TLS 미지원 플릿: `ec2-.compute.amazonaws.com`.
startTime
이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.
endTime
이 요청이 이행된 시간을 나타내는 타임스탬프입니다.
gameSessionRegion
AWS 게임 세션을 호스팅하는 플릿의 홈 리전입니다.
gameSessionLocation
게임 세션이 실행 중인 플릿 위치입니다. 이 값은 플릿의 홈 리전 또는 원격 위치를 지정할 수 있습니다.
playerGatewayStatus
이 게임 세션을 실행하는 플릿 위치에서 플레이어 게이트웨이의 상태입니다.
가능한 값은 다음과 같습니다.
+ `ENABLED` - 플레이어 게이트웨이는이 게임 세션의 플레이어 연결을 라우팅하는 데 사용할 수 있습니다.
+ `DISABLED` -이 게임 세션에는 플레이어 게이트웨이를 사용할 수 없습니다.
computeName
게임 세션을 호스팅하는 컴퓨팅 리소스에 대한 설명 레이블입니다. EC2 플릿의 경우 EC2 인스턴스 ID입니다. 컨테이너 플릿의 경우 플릿 인스턴스의 각 게임 서버 컨테이너 그룹에 컴퓨팅 이름이 할당됩니다. Anywhere 플릿의 경우 사용자 지정 컴퓨팅 이름입니다.
placedPlayerSessions
게임 세션 배치 요청에서 각 플레이어에 대해 생성된 플레이어 세션 모음입니다.
### 예제
```
{
"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
GameLift 서비스 [StopGameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StopGameSessionPlacement.html)의 호출과 함께 배치 요청이 취소되었습니다.
**세부 정보:**
placementId
게임 세션 배치 요청에 할당된 고유 식별자입니다.
startTime
이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.
endTime
이 요청이 취소된 시간을 나타내는 타임스탬프입니다.
### 예제
```
{
"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
대기열의 제한 시간이 만료되기 전에 게임 세션 배치가 성공적으로 완료되지 않았습니다. 배치 요청은 필요에 따라 다시 제출할 수 있습니다.
**세부 정보:**
placementId
게임 세션 배치 요청에 할당된 고유 식별자입니다.
startTime
이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.
endTime
이 요청이 취소된 시간을 나타내는 타임스탬프입니다.
### 예제
```
{
"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 Servers는 게임 세션 요청을 처리할 수 없었습니다. 이는 일반적으로 예상치 못한 내부 오류로 인해 발생합니다. 배치 요청은 필요에 따라 다시 제출할 수 있습니다.
**세부 정보:**
placementId
게임 세션 배치 요청에 할당된 고유 식별자입니다.
startTime
이 요청이 대기열에 배치된 시간을 나타내는 타임스탬프입니다.
endTime
이 요청에 실패한 시간을 나타내는 타임스탬프입니다.
### 예제
```
{
"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"
}
}
```