이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
를 사용한 Amazon GameLift 예제 AWS CLI
다음 코드 예제에서는 Amazon 와 AWS Command Line Interface 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 GameLift.
작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.
주제
작업
다음 코드 예시에서는 create-build
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
Example1: S3 버킷의 파일에서 게임 빌드를 생성하려면
다음
create-build
예제에서는 사용자 지정 게임 빌드 리소스를 생성합니다. 제어하는 AWS 계정의 S3 위치에 저장된 압축 파일을 사용합니다. 이 예제에서는 Amazon에 S3 위치에 액세스할 수 있는 GameLift 권한을 부여하는 IAM 역할을 이미 생성했다고 가정합니다. 요청이 운영 체제를 지정하지 않으므로 새 빌드 리소스의 기본값은 WINDOWS_2012입니다.aws gamelift create-build \ --storage-location
file://storage-loc.json
\ --nameMegaFrogRaceServer.NA
\ --build-version12345.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" } }
Example2: 에 파일을 수동으로 업로드하기 위한 게임 빌드 리소스를 생성하려면 GameLift
다음
create-build
예제에서는 새 빌드 리소스를 생성합니다. 또한 Amazon S3의 위치에 게임 빌드를 수동으로 업로드할 수 있는 스토리지 GameLift 위치 및 임시 자격 증명도 가져옵니다. 빌드를 성공적으로 업로드하면 GameLift 서비스가 빌드를 검증하고 새 빌드의 상태를 업데이트합니다.aws gamelift create-build \ --name
MegaFrogRaceServer.NA
\ --build-version12345.678
\ --operating-systemAMAZON_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 개발자 안내서의 에 사용자 지정 서버 빌드 업로드 GameLift를 참조하세요.
-
자세한 API 내용은 명령 참조CreateBuild
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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-idbuild-1111aaaa-22bb-33cc-44dd-5555eeee66ff
\ --certificate-configuration 'CertificateType=GENERATED
' \ --ec2-instance-typec4.large
\ --fleet-typeON_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-idbuild-2222aaaa-33bb-44cc-55dd-6666eeee77ff
\ --certificate-configuration 'CertificateType=GENERATED
' \ --ec2-instance-typec4.large
\ --fleet-typeSPOT
\ --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-idbuild-2222aaaa-33bb-44cc-55dd-6666eeee77ff
\ --certificate-configuration 'CertificateType=GENERATED
' \ --ec2-instance-typec4.large
\ --ec2-inbound-permissions 'FromPort=33435,ToPort=33435,IpRange=10.24.34.0/23,Protocol=UDP
' \ --fleet-typeSPOT
\ --new-game-session-protection-policyFullProtection
\ --runtime-configurationfile://runtime-config.json
\ --metric-groupsdefault
\ --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 서버는 Linux 시스템에 배포됩니다. 이 예제에서는 업로드된 Realtime 스크립트에 여러 스크립트 파일이 포함되어 있고Init()
함수가 라는 스크립트 파일에 있다고 가정합니다MainScript.js
. 그림과 같이 이 파일은 런타임 구성에서 시작 스크립트로 식별됩니다.aws gamelift create-fleet \ --name
MegaFrogRace.NA.realtime
\ --description 'Mega Frog Race Realtime fleet
' \ --script-idscript-1111aaaa-22bb-33cc-44dd-5555eeee66ff
\ --ec2-instance-typec4.large
\ --fleet-typeSPOT
\ --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 내용은 명령 참조CreateFleet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-game-session-queue
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
Example1: 순서가 지정된 게임 세션 대기열을 설정하려면
다음
create-game-session-queue
예제에서는 두 리전의 대상을 사용하여 새 게임 세션 대기열을 생성합니다. 또한 배치를 위해 10분을 기다린 후 게임 세션이 제한 시간을 요청하도록 대기열을 구성합니다. 지연 시간 정책이 정의되지 않았으므로 는 첫 번째 대상이 나열된 모든 게임 세션을 배치하려고 GameLift 시도합니다.aws gamelift create-game-session-queue \ --name
MegaFrogRaceServer-NA
\ --destinationsfile://destinations.json
\ --timeout-in-seconds600
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"} ] } ] }
Example2: 플레이어 지연 시간 정책을 사용하여 게임 세션 대기열을 설정하려면
다음
create-game-session-queue
예제에서는 두 개의 플레이어 지연 시간 정책을 사용하여 새 게임 세션 대기열을 생성합니다. 첫 번째 정책은 게임 세션 배치 시도의 첫 1분 동안 적용되는 100ms 지연 시간 한도를 설정합니다. 두 번째 정책은 배치 요청 시간이 3분으로 초과될 때까지 지연 시간 한도를 200ms로 높입니다.aws gamelift create-game-session-queue \ --name
MegaFrogRaceServer-NA
\ --destinationsfile://destinations.json
\ --player-latency-policiesfile://latency-policies.json
\ --timeout-in-seconds180
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 개발자 안내서의 대기열 생성을 참조하세요.
-
자세한 API 내용은 명령 참조CreateGameSessionQueue
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-build
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
사용자 지정 게임 빌드를 삭제하려면
다음
delete-build
예제에서는 Amazon GameLift 계정에서 빌드를 제거합니다. 빌드가 삭제된 후에는 새 플릿을 생성하는 데 사용할 수 없습니다. 이 작업은 실행 취소할 수 없습니다.aws gamelift delete-build \ --build-id
build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조DeleteBuild
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-fleet
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
더 이상 사용되지 않는 플릿을 삭제하려면
다음
delete-fleet
예제에서는 인스턴스가 0으로 축소된 플릿을 제거합니다. 플릿 용량이 0보다 크면 요청이 실패하고 HTTP 400 오류가 발생합니다.aws gamelift delete-fleet \ --fleet-id
fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 Amazon GameLift 개발자 안내서의 GameLift 플릿 관리를 참조하세요.
-
자세한 API 내용은 명령 참조DeleteFleet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-game-session-queue
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
게임 세션 대기열을 삭제하려면
다음
delete-game-session-queue
예제에서는 지정된 게임 세션 대기열을 삭제합니다.aws gamelift delete-game-session-queue \ --name
MegaFrogRace-NA
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조DeleteGameSessionQueue
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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 개발자 안내서의 에 사용자 지정 서버 빌드 업로드 GameLift를 참조하세요.
-
자세한 API 내용은 명령 참조DescribeBuild
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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 개발자 안내서의 컴퓨팅 리소스 선택을 참조하세요.
-
API 자세한 내용은 AWS CLI 명령 참조의 DescribeEc2InstanceLimits
를 참조하세요.
-
다음 코드 예시에서는 describe-fleet-attributes
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
Example1: 플릿 목록의 속성을 보려면
다음
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" } } ] }
Example2: 모든 플릿에 대한 속성을 요청하려면
다음은 모든 상태의 모든 플릿에 대한 플릿 속성을
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-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE1
응답에
NextToken
값이 포함되지 않을 때까지 반복합니다.자세한 내용은 Amazon GameLift 개발자 안내서의 GameLift 플릿 설정을 참조하세요.
-
자세한 API 내용은 명령 참조DescribeFleetAttributes
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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 플릿 지표를 참조하세요.
-
자세한 API 내용은 명령 참조DescribeFleetCapacity
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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-time1579647600
\ --end-time1579649400
\ --limit5
출력:
{ "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 개발자 안내서의 GameLift 플릿 문제 디버그를 참조하세요.
-
자세한 API 내용은 명령 참조DescribeFleetEvents
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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 개발자 안내서의 GameLift 플릿 설정을 참조하세요.
-
자세한 API 내용은 명령 참조DescribeFleetPortSettings
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-fleet-utilization
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
Example1: 플릿 목록의 사용 데이터를 보려면
다음
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 } ] }
Example2: 모든 플릿에 대한 사용 데이터를 요청하려면
다음은 모든 상태의 모든 플릿에 대한 플릿 사용 데이터를
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" }
명령을 두 번째로 호출하여
NextToken
값을--next-token
파라미터에 인수로 전달하여 다음 두 결과를 확인합니다.aws gamelift describe-fleet-utilization \ --limit
2
\ --next-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjEXAMPLE2
응답에 더 이상 값이 출력
NextToken
에 포함되지 않을 때까지 반복합니다.자세한 내용은 Amazon GameLift 개발자 안내서의 GameLift 플릿 지표를 참조하세요.
-
자세한 API 내용은 명령 참조DescribeFleetUtilization
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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 개발자 안내서의 다중 리전 대기열 사용을 참조하세요.
-
자세한 API 내용은 명령 참조DescribeGameSessionQueues
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 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 개발자 안내서의 플릿에서 여러 프로세스 실행을 참조하세요.
-
자세한 API 내용은 명령 참조DescribeRuntimeConfiguration
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-builds
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
Example1: 사용자 지정 게임 빌드 목록을 가져오려면
다음
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-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC01NWYxZTZmMS1jY2FlLTQ3YTctOWI5ZS1iYjFkYTQwMjJEXAMPLE=
응답에
NextToken
값이 포함되지 않을 때까지 반복합니다.Example2: 실패 상태의 사용자 지정 게임 빌드 목록을 가져오려면
다음
list-builds
예제는 현재 상태가 인 현재 리전의 모든 게임 서버 빌드에 대한 속성을 검색합니다FAILED.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 내용은 명령 참조ListBuilds
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-fleets
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
Example1: 리전의 모든 플릿 목록을 가져오려면
다음
list-fleets
예제에서는 현재 리전IDs의 모든 플릿의 플릿을 표시합니다. 이 예제에서는 페이지 매김 파라미터를 사용하여 IDs 한 번에 두 개의 플릿을 검색합니다. 응답에는 검색할 결과가 더 많음을 나타내는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-tokeneyJhd3NBY2NvdW50SWQiOnsicyI6IjMwMjc3NjAxNjM5OCJ9LCJidWlsZElkIjp7InMiOiJidWlsZC00NDRlZjQxZS1hM2I1LTQ2NDYtODJmMy0zYzI4ZTgxNjVjEXAMPLE=
Example2: 특정 빌드 또는 스크립트가 있는 리전의 모든 플릿 목록을 가져오려면
다음
list-builds
예제에서는 지정된 게임 빌드와 함께 배포된 플릿IDs의 를 검색합니다. Realtime Servers를 사용하는 경우 빌드 ID 대신 스크립트 ID를 제공할 수 있습니다. 이 예제에서는 제한 파라미터를 지정하지 않으므로 결과에 최대 16개의 플릿이 포함될 수 있습니다IDs.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 내용은 명령 참조ListFleets
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 request-upload-credentials
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
빌드 업로드를 위한 액세스 자격 증명을 새로 고치려면
다음
create-build
예제에서는 Amazon S3 위치에 GameLift 빌드 파일을 업로드하기 위한 새롭고 유효한 액세스 자격 증명을 가져옵니다. 자격 증명의 수명은 제한적입니다. 원래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 개발자 안내서의 에 사용자 지정 서버 빌드 업로드 GameLift를 참조하세요.
-
자세한 API 내용은 명령 참조RequestUploadCredentials
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 start-fleet-actions
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
플릿 자동 조정 활동을 다시 시작하려면
다음
start-fleet-actions
예제에서는 지정된 플릿에 정의되었지만 ``stop-fleet-actions``를 호출하여 중지된 모든 조정 정책의 사용을 재개합니다. 시작 후 조정 정책은 즉시 해당 지표를 추적하기 시작합니다.aws gamelift start-fleet-actions \ --fleet-id
fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
\ --actionsAUTO_SCALING
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조StartFleetActions
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 stop-fleet-actions
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
플릿의 자동 조정 활동을 중지하려면
다음
stop-fleet-actions
예제에서는 지정된 플릿에 정의된 모든 조정 정책의 사용을 중지합니다. 정책이 일시 중지된 후 수동으로 조정하지 않는 한 플릿 용량은 동일한 활성 인스턴스 수로 유지됩니다.aws gamelift start-fleet-actions \ --fleet-id
fleet-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
\ --actionsAUTO_SCALING
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조StopFleetActions
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-build
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
사용자 지정 게임 빌드를 업데이트하려면
다음
update-build
예제에서는 지정된 빌드 리소스와 연결된 이름 및 버전 정보를 변경합니다. 반환된 빌드 객체는 변경 사항이 성공적으로 이루어졌는지 확인합니다.aws gamelift update-build \ --build-id
build-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
\ --nameMegaFrogRaceServer.NA.east
\ --build-version12345.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 개발자 안내서의 빌드 파일 업데이트를 참조하세요.
-
자세한 API 내용은 명령 참조UpdateBuild
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-game-session-queue
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
게임 세션 대기열 구성을 업데이트하려면
다음
update-game-session-queue
예제에서는 새 대상을 추가하고 기존 게임 세션 대기열에 대한 플레이어 지연 시간 정책을 업데이트합니다.aws gamelift update-game-session-queue \ --name
MegaFrogRace-NA
\ --destinationsfile://destinations.json
\ --player-latency-policiesfile://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 개발자 안내서의 다중 리전 대기열 사용을 참조하세요.
-
자세한 API 내용은 명령 참조UpdateGameSessionQueue
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 upload-build
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
Example1: Linux 게임 서버 빌드 업로드
다음
upload-build
예제에서는 Linux 게임 서버 빌드 파일을 파일 디렉터리에서 GameLift 서비스로 업로드하고 빌드 리소스를 생성합니다.aws gamelift upload-build \ --name
MegaFrogRaceServer.NA
\ --build-version2.0.1
\ --build-root~/MegaFrogRace_Server/release-na
\ --operating-systemAMAZON_LINUX_2
--server-sdk-version4.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
Example2: Windows 게임 서버 빌드 업로드
다음
upload-build
예제에서는 디렉터리에서 GameLift 서비스로 Windows 게임 서버 빌드 파일을 업로드하고 빌드 레코드를 생성합니다.aws gamelift upload-build \ --name
MegaFrogRaceServer.NA
\ --build-version2.0.1
\ --build-root C:\MegaFrogRace_Server\release-na \ --operating-systemWINDOWS_2012
--server-sdk-version4.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 개발자 안내서의 에 사용자 지정 서버 빌드 업로드 GameLift를 참조하세요.
-
자세한 API 내용은 명령 참조UploadBuild
의 섹션을 참조하세요. AWS CLI
-