플릿 워크플로
경고: 이 콘텐츠는 기술 자료의 미리 보기입니다. 코드 샘플이 포함된 전체 기술 자료는 아직 제작 중입니다. 이 페이지 하단의 피드백 메커니즘을 통해 피드백을 제공해 주십시오.
플릿 워크플로는 빌드 구성 가져오기, 플릿 가져오거나 만들기, 플릿 업데이트를 지원합니다.
빌드 워크플로를 사용하기 전에 CCD API 키와 더불어 다음 역할이 부여된 UGS 서비스 계정이 있어야 합니다.
- Multiplay API 조회자
- Multiplay API 편집자
참고: 이 워크플로 전반에서 Unity 프로젝트 ID와 환경 ID를 참조해야 합니다. 프로젝트 설정 페이지와 환경 페이지에서 각각 프로젝트 ID와 환경 ID를 찾을 수 있습니다.
다음 다이어그램은 간소화된 버전의 워크플로를 보여 줍니다.
빌드 구성 가져오기
빌드 구성 나열 API를 사용하여 빌드 구성을 가져올 수 있습니다. 빌드 구성 워크플로를 참고하십시오.
참고: 빌드 구성 ID를 저장해야 합니다. 이미 빌드 구성 ID가 있는 경우 플릿 가져오기로 계속 진행합니다.
다음 코드 샘플은 curl을 사용하여 기존 빌드 구성을 가져오는 방법을 보여 줍니다.
curl -X GET \
-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \
https://services.api.unity.com/multiplay/build-configurations/v1/projects/{projectId}/environments/{environmentId}/build-configurations응답 본문 예시와 파라미터는 빌드 구성 나열 API 기술 자료를 참고하십시오.
플릿 가져오기
플릿을 가져오는 프로세스는 기존 플릿을 사용할지 혹은 새 플릿을 만들지에 따라 달라집니다. 기존 플릿을 사용하되 업데이트하려는 경우 플릿 업데이트를 참고하십시오.
기존 플릿 가져오기
플릿 나열 API를 사용하여 이름을 기준으로 플릿 ID를 가져올 수 있습니다. 이미 플릿 ID를 알고 있고 플릿을 업데이트하려는 경우 플릿 업데이트로 계속 진행합니다.
다음 코드 샘플은 curl을 사용하여 기존 플릿을 가져오는 방법을 보여 줍니다.
curl -X GET \
-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \
https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets응답 본문 예시와 파라미터는 플릿 나열 API 기술 자료를 참고하십시오.
새 플릿 만들기
플릿 만들기 API를 사용하여 플릿을 만들 수 있습니다. 플릿을 만들 때 게임 서버를 배치할 영역을 구성해야 합니다. 템플릿 플릿 영역 나열 API에서 유효한 영역 ID를 찾을 수 있습니다. curl을 사용하여 이 API를 호출할 수 있습니다.
curl -X GET \
-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \
https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets/regions다음 코드 샘플은 curl을 사용하여 새 플릿을 만드는 방법을 보여 줍니다.
curl -X POST \
-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \
-H "Content-Type: application/json" \
-d '{"buildConfigurations": [<BUILD_CONFIG_ID>], "name": "Example Fleet", "osFamily": "LINUX", "osID": "1111a1a1-a11a-11a1-a1a1-1a111aa11111", "regions": [{"maxServers": 10, "minAvailableServers": 10, "regionID": "<REGION_ID>"}]}' \
https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets응답 본문 예시와 파라미터는 플릿 만들기 API 기술 자료를 참고하십시오.
플릿 업데이트
플릿 업데이트 API를 사용하여 기존 플릿을 업데이트할 수 있습니다.
참고: 기존 플릿을 사용하는 경우에만 플릿을 업데이트하십시오. 새 플릿을 만드는 경우에는 업데이트 워크플로를 사용할 필요가 없습니다.
다음 코드 샘플은 curl을 사용하여 플릿을 업데이트하는 방법을 보여 줍니다.
curl -X PUT \
-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \
-H "Content-Type: application/json" \
-d '{"buildConfigurations": [<BUILD_CONFIG_ID>], "deleteTTL": 604800, "disabledDeleteTTL": 604800, "name": "Example Fleet", "shutdownTTL": 900}' \
https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets/{fleetId}응답 본문 예시와 파라미터는 플릿 업데이트 API 기술 자료를 참고하십시오.