> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Multiplayer Servers

> 빌드, 서버, 자산, 컨테이너 이미지, 할당량을 포함한 PlayFab Multiplayer Servers를 관리합니다.

`playfab mps` 명령 패밀리는 실험적 기능입니다. CLI 인터페이스는 피드백에 따라 변경되거나
제거될 수 있습니다.

`playfab mps`는 PlayFab Multiplayer Servers(MPS)의 빌드와 그 별칭 및 지역, 서버, 자산,
인증서, 비밀, 컨테이너 이미지, 할당량, 가상 머신(VM)을 관리합니다. PlayFab의
[MpsPowershell](https://github.com/PlayFab/MpsPowershell) 모듈과 같은 작업을 다루며, 이 모듈의
`Set-PfTitle`에 해당하는 것은 `xbox context set playfab-title-id <id>`입니다. [컨텍스트](https://docs.xbox.com/ko/tools/xbox-cli/commands/context.md)를 참조하세요.

```bash theme={null}
xbox --playfab-title-id ABC123 --output json-compact --data-only playfab mps build list
```

## 명령 트리

각 명령은 `xbox playfab mps` 아래에서 실행됩니다.

| 명령 | PlayFab API 경로 | 설명 |
| - | - | - |
| `title enable` | `/MultiplayerServer/EnableMultiplayerServersForTitle` | 타이틀에 MPS를 활성화합니다. |
| `title status` | `/MultiplayerServer/GetTitleEnabledForMultiplayerServersStatus` | 타이틀에 MPS가 활성화되어 있는지 확인합니다. |
| `build get` | `/MultiplayerServer/GetBuild` | 빌드를 가져옵니다. |
| `build list` | `/MultiplayerServer/ListBuildSummariesV2` | 빌드의 한 페이지를 나열합니다. |
| `build create` | `--type`에 따라 다름 | 빌드를 생성합니다. [`mps build create`](#mps-build-create)를 참조하세요. |
| `build update-name` | `/MultiplayerServer/UpdateBuildName` | 빌드 이름을 바꿉니다. |
| `build delete` | `/MultiplayerServer/DeleteBuild` | 빌드를 삭제합니다. |
| `build alias get` | `/MultiplayerServer/GetBuildAlias` | 빌드 별칭을 가져옵니다. |
| `build alias list` | `/MultiplayerServer/ListBuildAliases` | 빌드 별칭의 한 페이지를 나열합니다. |
| `build alias create` | `/MultiplayerServer/CreateBuildAlias` | 빌드 별칭을 생성합니다. |
| `build alias update` | `/MultiplayerServer/UpdateBuildAlias` | 빌드 별칭을 업데이트합니다. |
| `build alias delete` | `/MultiplayerServer/DeleteBuildAlias` | 빌드 별칭을 삭제합니다. |
| `build region update` | `/MultiplayerServer/UpdateBuildRegion` | 빌드의 지역 하나를 업데이트합니다. |
| `build region update-all` | `/MultiplayerServer/UpdateBuildRegions` | 빌드의 모든 지역을 업데이트합니다. |
| `build region delete` | `/MultiplayerServer/DeleteBuildRegion` | 빌드에서 지역을 제거합니다. |
| `server get` | `/MultiplayerServer/GetMultiplayerServerDetails` | 서버 세션의 세부 정보를 가져옵니다. |
| `server list` | `/MultiplayerServer/ListMultiplayerServers` | 한 지역에 있는 빌드의 서버 세션 한 페이지를 나열합니다. |
| `server list-archived` | `/MultiplayerServer/ListArchivedMultiplayerServers` | 빌드의 보관된 서버 세션 한 페이지를 나열합니다. |
| `server request` | `/MultiplayerServer/RequestMultiplayerServer` | 서버 세션을 요청합니다. |
| `server shutdown` | `/MultiplayerServer/ShutdownMultiplayerServer` | 서버 세션을 종료합니다. |
| `server get-logs` | `/MultiplayerServer/GetMultiplayerServerLogs` | 종료된 서버의 로그를 가져옵니다. |
| `server get-session-logs` | `/MultiplayerServer/GetMultiplayerSessionLogsBySessionId` | 세션 ID로 종료된 서버의 로그를 가져옵니다. |
| `asset list` | `/MultiplayerServer/ListAssetSummaries` | 자산의 한 페이지를 나열합니다. |
| `asset upload` | `/MultiplayerServer/GetAssetUploadUrl` | 로컬 파일을 자산으로 업로드합니다. [`mps asset upload`](#mps-asset-upload)를 참조하세요. |
| `asset delete` | `/MultiplayerServer/DeleteAsset` | 자산을 삭제합니다. |
| `asset get-upload-url` | `/MultiplayerServer/GetAssetUploadUrl` | 자산을 업로드할 URL을 가져옵니다. |
| `asset get-download-url` | `/MultiplayerServer/GetAssetDownloadUrl` | 자산을 다운로드할 URL을 가져옵니다. |
| `certificate list` | `/MultiplayerServer/ListCertificateSummaries` | 인증서의 한 페이지를 나열합니다. |
| `certificate upload` | `/MultiplayerServer/UploadCertificate` | 인증서를 업로드합니다. [`mps certificate upload`](#mps-certificate-upload-and-mps-secret-upload)를 참조하세요. |
| `certificate delete` | `/MultiplayerServer/DeleteCertificate` | 인증서를 삭제합니다. |
| `secret list` | `/MultiplayerServer/ListSecretSummaries` | 비밀의 한 페이지를 나열합니다. |
| `secret upload` | `/MultiplayerServer/UploadSecret` | 비밀을 업로드합니다. [`mps secret upload`](#mps-certificate-upload-and-mps-secret-upload)를 참조하세요. |
| `secret delete` | `/MultiplayerServer/DeleteSecret` | 비밀을 삭제합니다. |
| `container-image list` | `/MultiplayerServer/ListContainerImages` | 사용자 지정 컨테이너 이미지의 한 페이지를 나열합니다. |
| `container-image list-tags` | `/MultiplayerServer/ListContainerImageTags` | 컨테이너 이미지 태그의 한 페이지를 나열합니다. |
| `container-image untag` | `/MultiplayerServer/UntagContainerImage` | 컨테이너 이미지에서 태그를 제거합니다. |
| `container-image repository delete` | `/MultiplayerServer/DeleteContainerImageRepository` | 컨테이너 이미지 리포지토리를 삭제합니다. |
| `container-registry credentials get` | `/MultiplayerServer/GetContainerRegistryCredentials` | 컨테이너 레지스트리의 자격 증명을 가져옵니다. |
| `container-registry credentials rollover` | `/MultiplayerServer/RolloverContainerRegistryCredentials` | 컨테이너 레지스트리의 자격 증명을 교체합니다. |
| `quota get` | `/MultiplayerServer/GetTitleMultiplayerServersQuotas` | 타이틀의 MPS 할당량을 가져옵니다. |
| `quota change get` | `/MultiplayerServer/GetTitleMultiplayerServersQuotaChange` | 할당량 변경 요청을 가져옵니다. |
| `quota change list` | `/MultiplayerServer/ListTitleMultiplayerServersQuotaChanges` | 모든 할당량 변경 요청을 나열합니다. |
| `quota change create` | `/MultiplayerServer/CreateTitleMultiplayerServersQuotaChange` | 할당량 변경을 요청합니다. |
| `qos-server list` | `/MultiplayerServer/ListQosServersForTitle` | 타이틀의 QoS 서버를 나열합니다. |
| `party-qos-server list` | `/MultiplayerServer/ListPartyQosServers` | PlayFab Party QoS 서버를 나열합니다. |
| `virtual-machine list` | `/MultiplayerServer/ListVirtualMachineSummaries` | VM의 한 페이지를 나열합니다. |
| `remote-user create` | `/MultiplayerServer/CreateRemoteUser` | 빌드의 VM에 로그인하기 위한 원격 사용자를 생성합니다. |
| `remote-user delete` | `/MultiplayerServer/DeleteRemoteUser` | 원격 사용자를 삭제합니다. |
| `remote-login get-endpoint` | `/MultiplayerServer/GetRemoteLoginEndpoint` | 빌드를 호스팅하는 VM의 원격 로그인 엔드포인트를 가져옵니다. |
| `party request` | `/Party/RequestPartyService` | PlayFab Party 세션을 요청합니다. |

## 요청 본문

대부분의 MPS 명령은 [`playfab api`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/api)처럼 작업의 JSON
요청 개체를 보냅니다.

| 옵션 | 설명 |
| - | - |
| `--body` | 인라인 JSON 요청 본문입니다. 두 본문 옵션을 모두 전달하지 않으면 기본값은 `{}`입니다. |
| `--body-file` | JSON 요청 본문이 들어 있는 파일의 경로 또는 stdin에서 읽기 위한 `-`. |

`--body`와 `--body-file`은 함께 사용할 수 없습니다. `certificate upload`와 `secret upload`는
`--body-file`만 사용하며, `asset upload`는 둘 다 사용하지 않습니다. 해당 섹션을 참조하세요.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build get --body '{ "BuildId": "11111111-2222-3333-4444-555555555555" }'
xbox --playfab-title-id ABC123 --data-only playfab mps server list --body '{ "BuildId": "11111111-2222-3333-4444-555555555555", "Region": "EastUs" }'
```

## 파괴적 명령

다음 명령은 터미널에서는 먼저 묻고, 그 밖의 환경에서는 `--confirm`(`--yes`, `-y`)이
필요합니다. `build delete`, `build alias delete`, `build region delete`, `server shutdown`,
`asset delete`, `certificate delete`, `secret delete`,
`container-image repository delete`, `remote-user delete`. `--body-file -`를 사용하면
터미널에서도 `--confirm`이 필요합니다. 무언가를 변경하는 그 밖의 MPS 명령은 묻지 않고
실행됩니다. [안전 및 파괴적 작업](https://docs.xbox.com/ko/tools/xbox-cli/safety.md)을 참조하세요.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build delete --body '{ "BuildId": "11111111-2222-3333-4444-555555555555" }' --confirm
```

## 페이징

다음 목록 명령은 호출당 결과의 한 페이지를 반환합니다.

* `build list`, `build alias list`
* `server list`, `server list-archived`
* `asset list`, `certificate list`, `secret list`
* `container-image list`, `container-image list-tags`
* `virtual-machine list`

결과가 더 있으면 응답의 `SkipToken`이 설정됩니다. 다음 페이지를 가져오려면 요청 본문에 그
값으로 `"SkipToken"`을 추가하고 다른 필드는 유지한 채, `SkipToken`이 `null`로 반환될 때까지
반복하세요. 한 페이지에 포함되는 결과 수를 변경하려면 요청 본문에 `"PageSize"`를 설정하세요.

빌드의 첫 번째 페이지를 가져옵니다.

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only playfab mps build list --body '{ "PageSize": 50 }'
```

`SkipToken`이 `null`이 아니면 해당 토큰을 전달하여 다음 페이지를 가져옵니다.

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only playfab mps build list --body '{ "PageSize": 50, "SkipToken": "<SkipToken from the previous page>" }'
```

테이블 출력에는 `SkipToken` 열이 없으므로, 결과가 더 있으면 테이블 다음에 보낼 토큰이 포함된
알림이 stderr에 출력됩니다.

## 테이블 출력

다음 표의 명령은 `--output table`을 허용하며, 그 밖의 MPS 명령은 허용하지 않습니다.
[테이블 출력](https://docs.xbox.com/ko/tools/xbox-cli/commands.md#table-output)을 참조하세요.

| 명령 | 열 |
| - | - |
| `build list` | `BUILD ID`, `NAME`, `CREATED` |
| `build alias list` | `ALIAS ID`, `NAME` |
| `server list` | `SERVER ID`, `REGION`, `STATE`, `SESSION ID` |
| `server list-archived` | `SERVER ID`, `REGION`, `STATE`, `LAST TRANSITION` |
| `asset list` | `FILE NAME` |
| `certificate list` | `NAME`, `THUMBPRINT` |
| `secret list` | `NAME`, `VERSION`, `EXPIRES` |
| `container-image list` | `IMAGE` |
| `container-image list-tags` | `TAG` |
| `quota change list` | `REQUEST ID`, `DESCRIPTION`, `PENDING`, `APPROVED` |
| `qos-server list` | `REGION`, `SERVER URL` |
| `party-qos-server list` | `REGION`, `SERVER URL` |
| `virtual-machine list` | `VM ID`, `STATE`, `HEALTH` |

단일 레코드를 반환하는 명령은 레코드를 한 행으로 표시합니다.

| 명령 | 열 |
| - | - |
| `title status` | `STATUS` |
| `build get` | `BUILD ID`, `NAME`, `STATUS`, `OS`, `VM SIZE` |
| `build alias get` | `ALIAS ID`, `NAME` |
| `server get` | `SERVER ID`, `STATE`, `REGION`, `SESSION ID`, `IPV4 ADDRESS` |
| `asset get-upload-url` | `FILE NAME`, `UPLOAD URL`(가려짐) |
| `asset get-download-url` | `FILE NAME`, `DOWNLOAD URL`(가려짐) |
| `container-registry credentials get` | `DNS NAME`, `USERNAME`, `PASSWORD`(가려짐) |
| `quota change get` | `REQUEST ID`, `DESCRIPTION`, `PENDING`, `APPROVED` |
| `remote-login get-endpoint` | `IPV4 ADDRESS`, `PORT` |

가려진 열은 값이 자격 증명이므로 `********`를 출력합니다. JSON 출력은 실제 값을
반환합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build list --output table
```

```text theme={null}
BUILD ID                              NAME            CREATED
------------------------------------  --------------  ------------------------
11111111-2222-3333-4444-555555555555  combat-sandbox  2026-04-26T22:15:16.7Z
22222222-3333-4444-5555-666666666666  lobby-service   2026-06-23T22:00:37.702Z
```

## `mps build create`

`build create`에는 호출할 PlayFab API를 선택하는 `--type`이 필요하며, 다른 MPS 명령처럼
요청 본문을 사용합니다.

| `--type` 값 | PlayFab API 경로 |
| - | - |
| `managed` | `/MultiplayerServer/CreateBuildWithManagedContainer` |
| `custom` | `/MultiplayerServer/CreateBuildWithCustomContainer` |
| `process` | `/MultiplayerServer/CreateBuildWithProcessBasedServer` |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build create --type managed --body-file managed-build.json
```

## `mps certificate upload` 및 `mps secret upload`

`certificate upload`와 `secret upload`는 요청 본문에 PFX 암호나 비밀 값이 들어 있으므로
`--body-file <path>` 또는 stdin의 경우 `--body-file -`로만 요청 본문을 받습니다. 셸 기록과
프로세스 목록에 값이 남는 `--body`는 거부합니다. 둘 다 `--output table`을 허용하지 않습니다.

| 명령 | 요청 필드 |
| - | - |
| `certificate upload` | `GameCertificate`(`Name`, `Base64EncodedValue`, PFX에 암호가 있는 경우 `Password`), `ForceUpdate`, `CustomTags` |
| `secret upload` | `GameSecret`(`Name`, `Value`, `ExpirationDate`), `ForceUpdate`, `CustomTags` |

`ForceUpdate`는 같은 이름을 가진 기존 인증서나 비밀을 대체합니다. 본문 파일은 소스 제어에
포함하지 말고, 업로드한 후에는 삭제하세요.

`certificate.json`에는 Base64로 인코딩된 PFX와 그 암호가 들어 있습니다.

```json theme={null}
{
  "GameCertificate": {
    "Name": "nod-arena-tls",
    "Base64EncodedValue": "<Base64-encoded PFX>",
    "Password": "<PFX password>"
  }
}
```

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps certificate upload --body-file certificate.json
```

비밀을 다른 파일에 쓰지 않고 본문을 만들려면 `--body-file -`로 파이프하세요. 여기서 `jq`는
자체 인수가 아니라 `api-key.txt`에서 값을 읽으므로, 값이 프로세스 목록에 나타나지 않습니다.

```bash theme={null}
jq -n --rawfile value api-key.txt \
  '{GameSecret: {Name: "nod-arena-api-key", Value: ($value | rtrimstr("\n"))}}' \
  | xbox --playfab-title-id ABC123 playfab mps secret upload --body-file -
```

## `mps asset upload`

`asset upload`는 로컬 파일을 멀티플레이어 서버 자산으로 업로드합니다. 요청 본문 대신 옵션을
사용하며, 자산 이름과 업로드 상태를 JSON으로 씁니다.

| 옵션 | 필수 | 설명 |
| - | - | - |
| `--file` | 예 | 업로드할 로컬 파일의 경로입니다. |
| `--asset-name` | 예 | PlayFab에 생성할 자산의 이름입니다. |
| `--buffer-size` | 아니요 | 업로드 블록 크기(바이트)입니다. 기본값은 `4194304`(4MiB)입니다. |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps asset upload --file gameserver.zip --asset-name gameserver.zip
```


## Related topics

- [Servers](https://docs.xbox.com/ko/services/playfab/multiplayer/servers/index.md)
- [List Multiplayer Servers](https://docs.xbox.com/api-reference/multiplayerserver/list-multiplayer-servers.md)
- [Request Multiplayer Server](https://docs.xbox.com/api-reference/multiplayerserver/request-multiplayer-server.md)
- [Shutdown Multiplayer Server](https://docs.xbox.com/api-reference/multiplayerserver/shutdown-multiplayer-server.md)
- [Multiplayer Servers 비교](https://docs.xbox.com/ko/services/playfab/multiplayer/servers/server-comparison.md)
