플릿 워크플로
Follow this workflow to create and manage fleets using the API.
읽는 시간 1분최근 업데이트: 21일 전
경고
경고: 이 콘텐츠는 기술 자료의 미리 보기입니다. 코드 샘플이 포함된 전체 기술 자료는 아직 제작 중입니다. 이 페이지 하단의 피드백 메커니즘을 통해 피드백을 제공해 주십시오.
- Multiplay API 조회자
- Multiplay API 편집자
참고
이 워크플로 전반에서 Unity 프로젝트 ID와 환경 ID를 참조해야 합니다. 프로젝트 설정 페이지와 환경 페이지에서 각각 프로젝트 ID와 환경 ID를 찾을 수 있습니다.
플릿 워크플로 다이어그램
빌드 구성 가져오기
빌드 구성 나열 API를 사용하여 빌드 구성을 가져올 수 있습니다. 빌드 구성 워크플로를 참고하십시오.참고
빌드 구성 ID를 저장해야 합니다. 이미 빌드 구성 ID가 있는 경우 플릿 가져오기로 계속 진행합니다.
응답 본문 예시와 파라미터는 빌드 구성 나열 API 기술 자료를 참고하십시오.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를 사용하여 이름을 기준으로 플릿 ID를 가져올 수 있습니다. 이미 플릿 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
새 플릿 만들기
플릿 만들기 API를 사용하여 플릿을 만들 수 있습니다. 플릿을 만들 때 게임 서버를 배치할 영역을 구성해야 합니다. 템플릿 플릿 영역 나열 API에서 유효한 영역 ID를 찾을 수 있습니다. curl을 사용하여 이 API를 호출할 수 있습니다.다음 코드 샘플은 curl을 사용하여 새 플릿을 만드는 방법을 보여 줍니다.curl -X GET \-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets/regions
응답 본문 예시와 파라미터는 플릿 만들기 API 기술 자료를 참고하십시오.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 -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}