> ## 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/ja-jp/tools/xbox-cli/cli-for-agents.md)を参照してください。

コマンドは、タイトル、販売者、またはサンドボックスを、フラグ、`XBOX_` 環境変数、または
`xbox context set` で保存された値から取得します。何かを変更するコマンドは、コマンド ラインで渡されなかった
各値を stderr に示すため、運用環境の変更を行う前に確認してください。
[コンテキスト](https://docs.xbox.com/ja-jp/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/ja-jp/tools/xbox-cli/commands/audience) | 常に |
| [`game create`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/game) | 常に |
| [`playtest create`、`update`、`publish`、`delete`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playtest) | 常に |
| [`sandbox create`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/sandbox) | 常に |
| [`test-account batch create`、`update`、`delete`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/test-account) | 常に |
| [`xbl config publish`](https://docs.xbox.com/ja-jp/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/ja-jp/tools/xbox-cli/commands/xbl#title-targeting) | 他のタイトルが構成を共有している場合。`--allow-shared-configuration` では確認がスキップされますが、`--confirm` ではスキップされません。 |
| [`pc sandbox set`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/pc) | 常に |

## コマンド名からはわからない処理

* [`playfab service-principal set`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/service-principal) が失敗すると、`set` が成功するまで、
  サービス プリンシパルがスタジオでアクセス権を持たない状態になる可能性があります。その場合、そのサービス プリンシパルとして
  サインインするパイプラインが停止することがあります。`--expected-version` を渡すと、他のユーザーの変更を上書きする代わりに
  `set` が失敗するようになります。
* [`playfab privacy export`](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/privacy) は、プレイヤーがプレイしたパブリッシャーの
  すべてのタイトルからプレイヤーのデータを集め、タイトルの通知用メール アドレスにメールで送信します。エクスポート
  とそのメールは取り消すことができません。
* 別のサンドボックスからの [`xbl config publish`](https://docs.xbox.com/ja-jp/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

- [エージェントから XBOX CLI を使用する](https://docs.xbox.com/ja-jp/tools/xbox-cli/cli-for-agents.md)
- [コマンド](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands.md)
- [マルチプレイヤー サーバー](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab/mps.md)
- [PlayFab API の統合](https://docs.xbox.com/ja-jp/tools/xbox-cli/playfab-api.md)
- [PlayFab](https://docs.xbox.com/ja-jp/tools/xbox-cli/commands/playfab.md)
