이 설명서는 의 버전 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
-