Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 를 사용한 Amazon GameLift Servers 예제 AWS CLI
다음 코드 예제에서는 Amazon GameLift Server와 AWS Command Line Interface 함께를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `create-build`
다음 코드 예시에서는 `create-build` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: S3 버킷의 파일에서 게임 빌드를 생성하는 방법**
다음 `create-build` 예시에서는 사용자 지정 게임 빌드 리소스를 생성합니다. 사용자가 제어하는 AWS 계정의 S3 위치에 저장된 압축 파일을 사용합니다. 이 예시에서는 Amazon GameLift에 S3 위치에 액세스할 수 있는 권한을 부여하는 IAM 역할을 이미 생성했다고 가정합니다. 요청에 운영 체제가 지정되지 않았으므로 새 빌드 리소스는 기본적으로 WINDOWS\$12012로 설정됩니다.
```
aws gamelift create-build \
--storage-location file://storage-loc.json \
--name MegaFrogRaceServer.NA \
--build-version 12345.678
```
`storage-loc.json`의 콘텐츠:
```
{
"Bucket":"MegaFrogRaceServer_NA_build_files"
"Key":"MegaFrogRaceServer_build_123.zip"
"RoleArn":"arn:aws:iam::123456789012:role/gamelift"
}
```
출력:
```
{
"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"
}
}
```
**예시 2: GameLift에 파일을 수동으로 업로드하기 위한 게임 빌드 리소스를 생성하는 방법**
다음 `create-build` 예시에서는 새로운 빌드 리소스를 생성합니다. 또한 게임 빌드를 Amazon S3의 GameLift 위치에 수동으로 업로드할 수 있는 스토리지 위치와 임시 자격 증명을 얻습니다. 빌드를 성공적으로 업로드하면 GameLift 서비스에서 빌드의 유효성을 검사하고 새 빌드의 상태를 업데이트합니다.
```
aws gamelift create-build \
--name MegaFrogRaceServer.NA \
--build-version 12345.678 \
--operating-system AMAZON_LINUX
```
출력:
```
{
"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=="
}
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Upload a Custom Server Build to GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-build.html) 섹션을 참조하세요.
### `create-fleet`
다음 코드 예시에서는 `create-fleet` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: 기본 Linux 플릿 생성**
다음 `create-fleet` 예시는 사용자 지정 서버 빌드를 호스팅하기 위해 최소한의 온디맨드 Linux 인스턴스로 구성된 플릿을 생성합니다. `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}]'
```
출력:
```
{
"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"
}
}
```
**예시 2: 기본 Windows 플릿 생성**
다음 `create-fleet` 예시는 사용자 지정 서버 빌드를 호스팅하기 위해 최소한의 스팟 Windows 인스턴스로 구성된 플릿을 생성합니다. `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}]'
```
출력:
```
{
"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"
}
}
```
**예시 3: 완전히 구성된 플릿 생성**
다음 `create-fleet` 예시는 사용자 지정 서버 빌드를 위한 스팟 Windows 인스턴스 플릿을 생성하며, 가장 일반적으로 사용되는 구성 설정이 제공됩니다
```
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'
```
`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}]
```
출력:
```
{
"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"
}
}
}
```
**예시 4: Realtime Servers 플릿 생성**
다음 `create-fleet` 예시에서는 Amazon GameLift에 업로드된 Realtime 구성 스크립트를 사용하여 스팟 인스턴스 플릿을 생성합니다. 모든 Realtime Servers는 Linux 머신에 배포됩니다. 이 예시에서는 업로드된 Realtime 스크립트에 여러 스크립트 파일이 포함되어 있고 `Init()` 함수는 스크립트 파일에 있는 `MainScript.js`로 가정합니다. 그림과 같이 이 파일은 런타임 구성에서 시작 스크립트로 식별됩니다.
```
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}]'
```
출력:
```
{
"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"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-fleet.html) 섹션을 참조하세요.
### `create-game-session-queue`
다음 코드 예시에서는 `create-game-session-queue` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: 순서가 지정된 게임 세션 대기열을 설정하는 방법**
다음 `create-game-session-queue` 예시에서는 두 리전의 대상으로 새 게임 세션 대기열을 생성합니다. 또한 게임 세션 요청이 10분 동안 대기한 후 시간 초과되도록 대기열을 구성합니다. 지연 시간 정책이 정의되어 있지 않으므로 GameLift는 모든 게임 세션을 첫 번째 대상에 배치하려고 시도합니다.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--timeout-in-seconds 600
```
`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" }
]
}
```
출력:
```
{
"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"}
]
}
]
}
```
**예시 2: 플레이어 지연 시간 정책을 사용하여 게임 세션 대기열을 설정하는 방법**
다음 `create-game-session-queue` 예시에서는 두 개의 플레이어 지연 시간 정책을 사용하여 새 게임 세션 대기열을 생성합니다. 첫 번째 정책은 게임 세션 배치 시도의 첫 1분 동안 적용되는 지연 시간 제한을 100ms로 설정합니다. 두 번째 정책은 배치 요청이 3분으로 제한될 때까지 지연 시간 한도를 200ms로 높입니다.
```
aws gamelift create-game-session-queue \
--name MegaFrogRaceServer-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json \
--timeout-in-seconds 180
```
`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" }
]
}
```
`latency-policies.json`의 콘텐츠:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 60}
]
}
```
출력:
```
{
"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"}
],
}
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Create a Queue](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html#queues-creating-cli)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/create-game-session-queue.html) 섹션을 참조하세요.
### `delete-build`
다음 코드 예시에서는 `delete-build` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**사용자 지정 게임 빌드를 삭제하는 방법**
다음 `delete-build` 예시에서는 Amazon GameLift 계정에서 빌드를 제거합니다. 빌드가 삭제된 후에는 새 플릿을 만드는 데 사용할 수 없습니다. 이 작업은 실행 취소할 수 없습니다.
```
aws gamelift delete-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-build.html) 섹션을 참조하세요.
### `delete-fleet`
다음 코드 예시에서는 `delete-fleet` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**더 이상 사용되지 않는 플릿을 삭제하는 방법**
다음 `delete-fleet` 예시에서는 인스턴스가 0으로 스케일 다운된 플릿을 제거합니다. 플릿 용량이 0보다 크면 HTTP 400 오류와 함께 요청이 실패합니다.
```
aws gamelift delete-fleet \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Manage GameLift Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-editing.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteFleet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-fleet.html) 섹션을 참조하세요.
### `delete-game-session-queue`
다음 코드 예시에서는 `delete-game-session-queue` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**게임 세션 대기열을 삭제하는 방법**
다음 `delete-game-session-queue` 예시에서는 지정된 게임 세션 대기열을 삭제합니다.
```
aws gamelift delete-game-session-queue \
--name MegaFrogRace-NA
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/delete-game-session-queue.html) 섹션을 참조하세요.
### `describe-build`
다음 코드 예시에서는 `describe-build` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**사용자 지정 게임 빌드에 대한 정보를 얻으려면**
다음 `describe-build` 예시에서는 게임 서버 빌드 리소스의 속성을 검색합니다.
```
aws gamelift describe-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:
```
{
"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"
}
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Upload a Custom Server Build to GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-builds)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-build.html) 섹션을 참조하세요.
### `describe-ec2-instance-limits`
다음 코드 예시에서는 `describe-ec2-instance-limits` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**EC2 인스턴스 유형에 대한 서비스 제한을 검색하는 방법**
다음 `describe-ec2-instance-limits` 예시에서는 현재 리전에서 지정된 EC2 인스턴스 유형에 대해 사용 중인 최대 허용 인스턴스와 현재 인스턴스를 보여줍니다. 그 결과 허용된 20개의 인스턴스 중 5개만 사용되고 있는 것으로 나타났습니다.
```
aws gamelift describe-ec2-instance-limits \
--ec2-instance-type m5.large
```
출력:
```
{
"EC2InstanceLimits": [
{
"EC2InstanceType": ""m5.large",
"CurrentInstances": 5,
"InstanceLimit": 20
}
]
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Choose Computing Resources](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeEc2InstanceLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-ec2-instance-limits.html) 섹션을 참조하세요.
### `describe-fleet-attributes`
다음 코드 예시에서는 `describe-fleet-attributes` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: 플릿 목록의 속성을 보는 방법**
다음 `describe-fleet-attributes` 예시에서는 지정된 두 플릿에 대한 플릿 속성을 검색합니다. 표시된 바와 같이 요청된 플릿은 동일한 빌드로 배포되며, 하나는 온디맨드 인스턴스용이고 다른 하나는 스팟 인스턴스용이지만 약간의 구성 차이가 있습니다.
```
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
```
출력:
```
{
"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"
}
}
]
}
```
**예시 2: 모든 플릿에 대한 속성을 요청하는 방법**
다음 `describe-fleet-attributes` 예시에서는 모든 상태의 모든 플릿에 대한 플릿 속성을 반환합니다. 이 예시에서는 페이지 매김 파라미터를 사용하여 한 번에 하나의 플릿을 반환하는 방법을 설명합니다.
```
aws gamelift describe-fleet-attributes \
--limit 1
```
출력:
```
{
"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"
}
```
출력에는 명령을 두 번째로 호출할 때 사용할 수 있는 `NextToken` 값이 포함됩니다. 값을 `--next-token` 파라미터에 전달하여 출력을 선택할 위치를 지정합니다. 다음 명령은 출력에 두 번째 결과를 반환합니다.
```
aws gamelift describe-fleet-attributes \
--limit 1 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1
```
응답에 `NextToken` 값이 포함되지 않을 때까지 반복합니다.
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Setting Up GameLift Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeFleetAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-attributes.html) 섹션을 참조하세요.
### `describe-fleet-capacity`
다음 코드 예시에서는 `describe-fleet-capacity` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**플릿 목록의 용량 상태를 보는 방법**
다음 `describe-fleet-capacity` 예시는 지정된 두 개의 플릿에 대한 현재 용량을 검색합니다.
```
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
```
출력:
```
{
"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
}
}
]
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeFleetCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-capacity.html) 섹션을 참조하세요.
### `describe-fleet-events`
다음 코드 예시에서는 `describe-fleet-events` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**지정된 기간 동안 이벤트를 요청하는 방법**
다음 `describe-fleet-events` 예제에서는 지정된 기간 동안 발생한 모든 플릿 관련 이벤트의 세부 정보를 표시합니다.
```
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
```
출력:
```
{
"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"
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Debug GameLift Fleet Issues](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeFleetEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-events.html) 섹션을 참조하세요.
### `describe-fleet-port-settings`
다음 코드 예시에서는 `describe-fleet-port-settings` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**플릿에 대한 인바운드 연결 권한 보기**
다음 `describe-fleet-port-settings` 예시에서는 지정된 플릿에 대한 연결 설정을 검색합니다.
```
aws gamelift describe-fleet-port-settings \
--fleet-id arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:
```
{
"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"
}
]
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Setting Up GameLift Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeFleetPortSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-port-settings.html) 섹션을 참조하세요
### `describe-fleet-utilization`
다음 코드 예시에서는 `describe-fleet-utilization` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: 플릿 목록의 사용량 데이터를 보는 방법**
다음 `describe-fleet-utilization` 예시에서는 지정된 플릿 하나에 대한 현재 사용 정보를 검색합니다.
```
aws gamelift describe-fleet-utilization \
--fleet-ids arn:aws:gamelift:us-west-2::fleet/fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:
```
{
"FleetUtilization": [
{
"FleetId": "fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"ActiveServerProcessCount": 100,
"ActiveGameSessionCount": 62,
"CurrentPlayerSessionCount": 329,
"MaximumPlayerSessionCount": 1000
}
]
}
```
**예시 2: 모든 플릿에 대한 사용 데이터를 요청하는 방법**
다음 `describe-fleet-utilization` 예시에서는 모든 상태의 모든 플릿에 대한 플릿 사용량 데이터를 반환합니다. 이 예시에서는 페이지 매김 파라미터를 사용하여 한 번에 두 개의 플릿에 대한 데이터를 반환합니다.
```
aws gamelift describe-fleet-utilization \
--limit 2
```
출력:
```
{
"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"
}
```
명령을 다시 한 번 호출하여 `--next-token` 파라미터에 `NextToken` 값을 인자로 전달하면 다음 두 가지 결과를 확인할 수 있습니다.
```
aws gamelift describe-fleet-utilization \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2
```
응답에 더 이상 `NextToken` 값이 출력에 포함되지 않을 때까지 반복합니다.
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [GameLift Metrics for Fleets](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html#gamelift-metrics-fleet)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeFleetUtilization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-fleet-utilization.html) 섹션을 참조하세요.
### `describe-game-session-queues`
다음 코드 예시에서는 `describe-game-session-queues` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**게임 세션 대기열을 보는 방법**
다음 `describe-game-session-queues`는 지정된 두 대기열의 속성을 검색합니다.
```
aws gamelift describe-game-session-queues \
--names MegaFrogRace-NA MegaFrogRace-EU
```
출력:
```
{
"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"
}
]
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Using Multi-Region Queues](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeGameSessionQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-game-session-queues.html) 섹션을 참조하세요.
### `describe-runtime-configuration`
다음 코드 예시에서는 `describe-runtime-configuration` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**플릿에 대한 런타임 구성 요청**
다음 `describe-runtime-configuration` 예시에서는 지정된 플릿의 현재 런타임 구성에 대한 세부 정보를 검색합니다.
```
aws gamelift describe-runtime-configuration \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:
```
{
"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
}
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Run Multiple Processes on a Fleet](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/describe-runtime-configuration.html) 섹션을 참조하세요.
### `list-builds`
다음 코드 예시에서는 `list-builds` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: 사용자 지정 게임 빌드 목록을 가져오는 방법**
다음 `list-builds` 예시에서는 현재 리전의 모든 게임 서버 빌드에 대한 속성을 검색합니다. 샘플 요청은 페이지 매김 파라미터인 `Limit` 및 `NextToken`을 사용하여 순차적으로 결과를 검색하는 방법을 보여줍니다. 첫 번째 명령은 처음 두 개의 빌드를 검색합니다. 사용 가능한 결과가 두 개 이상이기 때문에 응답에는 더 많은 결과를 사용할 수 있음을 나타내는 `NextToken`이 포함됩니다.
```
aws gamelift list-builds \
--limit 2
```
출력:
```
{
"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="
}
```
그런 다음 다음과 같이 `--next-token` 파라미터를 사용하여 명령을 다시 호출하면 다음 두 개의 빌드를 확인할 수 있습니다.
```
aws gamelift list-builds \
--limit 2
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=
```
응답에 `NextToken` 값이 포함되지 않을 때까지 반복합니다.
**예시 2: 실패 상태의 사용자 지정 게임 빌드 목록을 가져오는 방법**
다음 `list-builds` 예시에서는 현재 실패 상태가 있는 현재 리전의 모든 게임 서버 빌드에 대한 속성을 검색합니다.
```
aws gamelift list-builds \
--status FAILED
```
출력:
```
{
"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"
}
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListBuilds](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-builds.html) 섹션을 참조하세요.
### `list-fleets`
다음 코드 예시에서는 `list-fleets` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: 리전의 모든 플릿 목록을 가져오는 방법**
다음 `list-fleets` 예시에서는 현재 리전에 있는 모든 플릿의 플릿 ID를 표시합니다. 이 예시에서는 페이지 매김 파라미터를 사용하여 한 번에 두 개의 플릿 ID를 검색합니다. 응답에는 검색할 결과가 더 있음을 나타내는 `next-token` 속성이 포함되어 있습니다.
```
aws gamelift list-fleets \
--limit 2
```
출력:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
],
"NextToken": "eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE="
}
```
여기에 표시된 것처럼 다음 명령에 이전 응답의 `NextToken` 값을 전달하여 다음 두 가지 결과를 얻을 수 있습니다.
```
aws gamelift list-fleets \
--limit 2 \
--next-token eyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=
```
**예시 2: 특정 빌드 또는 스크립트가 있는 리전의 모든 플릿 목록을 가져오는 방법**
다음 `list-builds` 예시에서는 지정된 게임 빌드와 함께 배포된 플릿의 ID를 검색합니다. Realtime Servers로 작업하는 경우 빌드 ID 대신 스크립트 ID를 제공할 수 있습니다. 이 예시에서는 제한 파라미터를 지정하지 않았으므로 결과에 최대 16개의 플릿 ID가 포함될 수 있습니다.
```
aws gamelift list-fleets \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:
```
{
"FleetIds": [
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE44444"
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListFleets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/list-fleets.html) 섹션을 참조하세요.
### `request-upload-credentials`
다음 코드 예시에서는 `request-upload-credentials` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**빌드 업로드를 위한 액세스 자격 증명을 새로 고치려면**
다음 `create-build` 예시에서는 GameLift 빌드 파일을 Amazon S3 위치에 업로드하기 위한 새롭고 유효한 액세스 자격 증명을 가져옵니다. 자격 증명은 수명이 제한되어 있습니다. 원래 `CreateBuild` 요청에 대한 응답에서 빌드 ID를 얻습니다.
```
aws gamelift request-upload-credentials \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
출력:
```
{
"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=="
}
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Upload a Custom Server Build to GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [RequestUploadCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/request-upload-credentials.html) 섹션을 참조하세요.
### `start-fleet-actions`
다음 코드 예시에서는 `start-fleet-actions` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**플릿 자동 조정 활동을 다시 시작하는 방법**
다음 `start-fleet-actions` 예시에서는 지정된 플릿에 정의되었지만 ``stop-fleet-actions``를 호출하여 중지된 모든 조정 정책의 사용을 재개합니다. 시작 후 조정 정책은 즉시 해당 지표를 추적하기 시작합니다.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [StartFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/start-fleet-actions.html) 섹션을 참조하세요.
### `stop-fleet-actions`
다음 코드 예시에서는 `stop-fleet-actions` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**플릿의 자동 조정 활동을 중지하는 방법**
다음 `stop-fleet-actions` 예시에서는 지정된 플릿에 정의된 모든 조정 정책의 사용을 중지합니다. 정책이 일시 중단된 후에도 수동으로 조정하지 않는 한 플릿 용량은 동일한 활성 인스턴스 수로 유지됩니다.
```
aws gamelift start-fleet-actions \
--fleet-id fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--actions AUTO_SCALING
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [StopFleetActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/stop-fleet-actions.html) 섹션을 참조하세요.
### `update-build`
다음 코드 예시에서는 `update-build` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**사용자 지정 게임 빌드를 업데이트하는 방법**
다음 `update-build` 예시에서는 지정된 빌드 리소스와 연결된 이름 및 버전 정보를 변경합니다. 반환된 빌드 객체는 변경 사항이 성공적으로 이루어졌는지 확인합니다.
```
aws gamelift update-build \
--build-id build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--name MegaFrogRaceServer.NA.east \
--build-version 12345.east
```
출력:
```
{
"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"
}
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Update Your Build Files](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html#gamelift-build-cli-uploading-update-build-files)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-build.html) 섹션을 참조하세요.
### `update-game-session-queue`
다음 코드 예시에서는 `update-game-session-queue` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**게임 세션 대기열 구성 업데이트**
다음 `update-game-session-queue` 예시에서는 새 대상을 추가하고 기존 게임 세션 대기열에 대한 플레이어 지연 시간 정책을 업데이트합니다.
```
aws gamelift update-game-session-queue \
--name MegaFrogRace-NA \
--destinations file://destinations.json \
--player-latency-policies file://latency-policies.json
```
`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"}
]
}
```
`latency-policies.json`의 콘텐츠:
```
{
"PlayerLatencyPolicies": [
{"MaximumIndividualPlayerLatencyMilliseconds": 200},
{"MaximumIndividualPlayerLatencyMilliseconds": 150, "PolicyDurationSeconds": 120},
{"MaximumIndividualPlayerLatencyMilliseconds": 100, "PolicyDurationSeconds": 120}
]
}
```
출력:
```
{
"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}
]
}
}
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Using Multi-Region Queues](https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateGameSessionQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-game-session-queue.html) 섹션을 참조하세요.
### `upload-build`
다음 코드 예시에서는 `upload-build` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**예시 1: Linux 게임 서버 빌드 업로드**
다음 `upload-build` 예시에서는 Linux 게임 서버 빌드 파일을 파일 디렉터리에서 GameLift 서비스로 업로드하고 빌드 리소스를 생성합니다.
```
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
```
출력:
```
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
```
**예시 2: Windows 게임 서버 빌드 업로드**
다음 `upload-build` 예시에서는 디렉터리에서 GameLift 서비스로 Windows 게임 서버 빌드 파일을 업로드하고 빌드 레코드를 생성합니다.
```
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
```
출력:
```
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
```
자세한 내용은 *Amazon GameLift 개발자 안내서*의 [Upload a Custom Server Build to GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-cli-uploading.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UploadBuild](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/upload-build.html) 섹션을 참조하세요.