> ## 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.

# CloudScript

> Classic CloudScript JavaScript 수정 버전과 CloudScript가 사용하는 Azure Functions 등록을 관리합니다.

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

PlayFab이 호스팅하는 JavaScript인 Classic CloudScript는 `classic`으로, CloudScript가 호출하는 Azure
Functions는 `function`으로 관리합니다. 이러한 명령은 모두 실행하기 전에 묻지 않습니다.

## `playfab cloudscript classic`

| 명령 | PlayFab API 경로 | 옵션 |
| - | - | - |
| `playfab cloudscript classic revision get` | `/Admin/GetCloudScriptRevision` | 선택적 `--version` 및 `--revision`이며, 둘 다 기본값은 최신입니다. |
| `playfab cloudscript classic version list` | `/Admin/GetCloudScriptVersions` | 없음. |
| `playfab cloudscript classic revision create` | `/Admin/UpdateCloudScript` | `--file`(필수)은 새 수정 버전으로 업로드할 JavaScript 파일입니다. `--publish`는 새 수정 버전을 라이브로 만들기도 합니다. |
| `playfab cloudscript classic revision publish` | `/Admin/SetPublishedRevision` | `--version` 및 `--revision`(둘 다 필수). |

## `playfab cloudscript function`

`function`은 CloudScript가 호출할 수 있도록 기존 Azure Functions를 PlayFab에 등록합니다. Azure에서는 아무것도
생성하거나 변경하지 않습니다.

| 명령 | PlayFab API 경로 | 옵션 |
| - | - | - |
| `playfab cloudscript function list` | `/CloudScript/ListFunctions`, 또는 `--type`을 사용하는 경우 `/CloudScript/ListHttpFunctions`, `/CloudScript/ListQueuedFunctions` 또는 `/CloudScript/ListEventHubFunctions` | 선택적 `--type`: `http`, `queued` 또는 `eventhub`. 모든 등록을 나열하려면 생략하세요. |
| `playfab cloudscript function register` | `/CloudScript/RegisterHttpFunction` | `--type http`, `--name`, `--url`(모두 필수), 선택적 `--key-file`. 등록할 수 있는 유형은 `http`뿐입니다. |
| `playfab cloudscript function unregister` | `/CloudScript/UnregisterFunction` | `--name`(필수). |

### 함수 키

Azure의 기본값인 함수 수준 권한 부여를 사용하는 HTTP 트리거 Azure Function에는 함수 키가 필요합니다. 키가
셸 기록과 프로세스 목록에 남지 않도록 URL 대신 파일로 키를 전달하세요.

| 옵션 | 설명 |
| - | - |
| `--url <url>` | 키를 제외한 함수의 URL입니다. `code` 쿼리 매개 변수가 있는 URL은 거부됩니다. |
| `--key-file <path>` | Azure Portal에 표시되는 함수 키를 담고 있는 파일이며, 파이프된 stdin에서 읽으려면 `-`를 지정합니다. 앞뒤 공백은 제거됩니다. 키가 필요 없는 함수의 경우 생략하세요. |

CLI는 키를 `code`로 URL에 추가하고, Azure Portal의 **함수 URL 가져오기**에 표시되는 것과 같은 URL을
등록합니다.

## 테이블 출력

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

| 명령 | 열 |
| - | - |
| `playfab cloudscript classic version list` | `VERSION`, `PUBLISHED REVISION`, `LATEST REVISION` |
| `playfab cloudscript function list` | `FUNCTION NAME` |

등록의 URL 및 기타 세부 정보를 보려면 JSON 출력을 사용하세요.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic version list --output table
```

```text theme={null}
VERSION  PUBLISHED REVISION  LATEST REVISION
-------  ------------------  ---------------
1        3                   5
2        1                   1
```

## 예제

게시된 버전을 확인하고 수정 버전을 읽습니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic version list
xbox --playfab-title-id ABC123 playfab cloudscript classic revision get --version 1 --revision 2
```

`main.js`를 새 수정 버전으로 업로드합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic revision create --file main.js
```

`create`는 새 수정 버전의 `Version`과 `Revision`을 반환합니다. 수정 버전을 검토한 후 해당 번호로 게시합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic revision publish --version 1 --revision 3
```

HTTP 함수 등록을 나열합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function list --type http
```

키가 `function-key.txt`에 있는 함수를 등록합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function register --type http --name MatchWebhook --url https://nodpublishers.azurewebsites.net/api/MatchWebhook --key-file ./function-key.txt
```

대신 비밀 저장소 같은 곳에서 stdin으로 키를 읽으려면 다음을 사용합니다.

```bash theme={null}
get-function-key | xbox --playfab-title-id ABC123 playfab cloudscript function register --type http --name MatchWebhook --url https://nodpublishers.azurewebsites.net/api/MatchWebhook --key-file -
```

키가 필요 없는 함수를 등록합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function register --type http --name PublicStatus --url https://nodpublishers.azurewebsites.net/api/PublicStatus
```

`MatchWebhook` 등록을 취소합니다.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function unregister --name MatchWebhook
```


## Related topics

- [CloudScript](https://docs.xbox.com/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript/index.md)
- [Cloud Script 실행](https://docs.xbox.com/ko/services/playfab/api-references/rest/client/server-side-cloud-script/execute-cloud-script.md)
- [Execute Cloud Script](https://docs.xbox.com/api-reference/server-side-cloud-script/execute-cloud-script.md)
- [CloudScript 빠른 시작](https://docs.xbox.com/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart.md)
- [CloudScript에서 오류 처리](https://docs.xbox.com/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript/handling-errors-in-cloudscript.md)
