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

# 안전 및 파괴적 작업

> 읽기만 하는 XBOX CLI 명령, 변경하기 전에 확인을 요청하는 명령, 이름만으로는 알 수 없는 작업을 수행하는 명령, 그리고 변경 결과를 알 수 없을 때 수행할 작업입니다.

XBOX CLI는 사용자의 권한으로, 종종 프로덕션 타이틀과 판매자를 대상으로 작동합니다. 이 페이지에서는
읽기만 하는 명령, 변경하기 전에 확인을 요청하는 명령, 이름만으로는 알 수 없는 작업을 수행하는
몇 가지 명령, 그리고 변경 결과를 알 수 없을 때 수행할 작업을 다룹니다. AI
에이전트가 변경 전에 확인해야 하는 사항은 [에이전트에서 XBOX CLI 사용](https://docs.xbox.com/ko/tools/xbox-cli/cli-for-agents.md)을 참조하세요.

명령은 플래그, `XBOX_` 환경 변수 또는 `xbox context set`으로 저장된 값에서 타이틀, 판매자 또는
샌드박스를 가져옵니다. 무언가를 변경하는 명령은 명령줄에서 전달하지 않은 각 값을
stderr에 표시하므로, 프로덕션 변경 전에 이를 확인하세요.
[컨텍스트](https://docs.xbox.com/ko/tools/xbox-cli/commands/context.md)를 참조하세요.

## 읽기 전용 항목

PlayFab 작업은 `/Admin/GetTitleData` 또는 `/MultiplayerServer/ListBuildSummariesV2`처럼
이름이 `Get`, `List` 또는 `Search`로 시작하는 경우에만 읽기 전용입니다. 그 밖의 모든 작업은
무언가를 변경합니다. 이는 명령 이름이 아니라 작업의 경로를 입력하는 `xbox playfab api <api-path>`에서
특히 중요합니다.

명령의 도움말에는 해당 명령이 무언가를 읽는지 변경하는지 알려 주는 `SAFETY` 섹션이 있습니다.

## 먼저 확인을 요청하는 항목

무언가를 변경하는 명령은 대부분 확인 없이 실행됩니다. 다음 명령은 터미널에서 먼저 확인을 요청하며,
터미널이 없으면 `--confirm`(`--yes`, `-y`)을 전달하지 않는 한 거부합니다.

| 명령 | 확인이 필요한 경우 |
| - | - |
| `playfab api`를 포함한 모든 명령을 통한 모든 PlayFab `Delete*` 또는 `Shutdown*` 작업 | 항상 |
| `playfab economy inventory operation execute` | 배치에 `Delete` 작업이 포함된 경우. 터미널에서도 `--confirm` 없이는 거부합니다. |
| `playfab api-policy set --overwrite` | 항상. 터미널에서도 `--confirm` 없이는 거부합니다. |
| [`audience create`, `audience update`](https://docs.xbox.com/ko/tools/xbox-cli/commands/audience) | 항상 |
| [`game create`](https://docs.xbox.com/ko/tools/xbox-cli/commands/game) | 항상 |
| [`playtest create`, `update`, `publish`, `delete`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playtest) | 항상 |
| [`sandbox create`](https://docs.xbox.com/ko/tools/xbox-cli/commands/sandbox) | 항상 |
| [`test-account batch create`, `update`, `delete`](https://docs.xbox.com/ko/tools/xbox-cli/commands/test-account) | 항상 |
| [`xbl config publish`](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl#config-publish) | RETAIL, CERT, CERT.DEBUG 또는 HIDDEN에 게시하거나 다른 샌드박스에서 게시하는 경우. `--validate-only`를 사용할 때는 확인하지 않습니다. |
| `--title-id`를 사용한 [`xbl config save`, `xbl config publish`](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl#title-targeting) | 다른 타이틀이 구성을 공유하는 경우. `--allow-shared-configuration`은 질문을 건너뛰지만 `--confirm`은 건너뛰지 않습니다. |
| [`pc sandbox set`](https://docs.xbox.com/ko/tools/xbox-cli/commands/pc) | 항상 |

## 명령 이름만으로는 알 수 없는 사항

* [`playfab service-principal set`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/service-principal)이 실패하면 `set`이
  성공할 때까지 서비스 주체가 스튜디오에 대한 액세스 권한을 갖지 못할 수 있으며, 이로 인해 해당 서비스 주체로
  로그인하는 파이프라인이 중지될 수 있습니다. 다른 사람의 변경 사항을 덮어쓰지 않고 `set`이 실패하도록
  `--expected-version`을 전달하세요.
* [`playfab privacy export`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/privacy)는 플레이어가 플레이한 게시자의 모든
  타이틀에 대한 플레이어 데이터를 타이틀의 알림 이메일 주소로 보냅니다. 내보내기와
  해당 이메일은 회수할 수 없습니다.
* 다른 샌드박스에서의 [`xbl config publish`](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl#cross-sandbox-publishing-replaces-global-title-storage-files)는
  대상의 전역 타이틀 스토리지 파일을 원본의 파일로 바꾸고, 대상에만 있는 파일을 삭제합니다.
  삭제된 파일은 복구할 수 없습니다.
* `xbl config publish --sandbox-id HIDDEN`은 RETAIL을 포함한 모든 샌드박스에서 사용하는
  타이틀 전체 구성을 게시합니다.

## 중단된 쓰기는 결과를 알 수 없다고 보고함

CLI가 변경 사항을 보낸 후 Ctrl+C, 시간 초과 또는 연결 끊김 등으로 변경이 중단되거나,
서비스가 HTTP 5xx 오류로 응답하면 변경이 적용되었을 수 있습니다.
명령은 다음 PlayFab 오류처럼 결과를 알 수 없다고 표시합니다.

```text theme={null}
Request failed: /Admin/SetTitleData may have reached PlayFab, but the request was canceled, so its outcome is unknown. Check whether it was applied before retrying.
```

| 명령 | 결과를 알 수 없을 때의 종료 코드 |
| - | - |
| `audience create` 및 `update`, `playtest create`, `update`, `publish` 및 `delete`, `sandbox create`, `test-account batch create`, `update` 및 `delete`, `xbl config save` 및 `publish` | `3` |
| 모든 `playfab` 명령을 포함한 기타 명령 | `1`. 단, `game create`는 요청을 보낸 후 Ctrl+C를 누르면 `130`으로 종료합니다. PlayFab이 오류 JSON으로 응답한 경우 stderr의 JSON에도 `outcomeUnknown` 필드가 있습니다. |

변경을 다시 실행하기 전에 영향을 받는 상태를 읽으세요. `playfab` 이외의 명령은 확인에 사용할
읽기 전용 명령을 출력합니다. CLI는 변경을 자동으로 다시 시도하지 않습니다.

작업을 기다리는 일부 명령은 요청이 수락되었지만 대기가 종료된 경우 `4`로 종료합니다.
명령을 다시 실행하지 마세요. 계속 기다리는 방법은 해당 명령의 페이지를 참조하세요.


## Related topics

- [명령](https://docs.xbox.com/ko/tools/xbox-cli/commands.md)
- [에이전트에서 XBOX CLI 사용](https://docs.xbox.com/ko/tools/xbox-cli/cli-for-agents.md)
- [PlayFab API 통합](https://docs.xbox.com/ko/tools/xbox-cli/playfab-api.md)
- [Multiplayer Servers](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/mps.md)
- [PlayFab](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab.md)
