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

# バックアップコマンド

> /backup コマンドグループ — サーバーのバックアップを Discord から作成・一覧表示・確認・復元・スケジュール設定・エクスポート・インポート・一括削除します。

`/backup` は [サーバーバックアップ](/ja/server-management/server-backup) を Discord の中から操作します。1 つのコマンドに **13 個のサブコマンド**があります。

| 要件              | 内容                                            |
| --------------- | --------------------------------------------- |
| **必要権限（あなた）**   | Manage Server                                 |
| **必要権限（Vetox）** | View Channel、Read Message History — 復元にはさらに必要 |
| **クールダウン**      | 5 秒                                           |
| **利用場所**        | サーバー内のみ。DM では利用できません                          |

<Warning>
  **`/backup` の返信はすべて、あなたにしか見えません。** バックアップ ID はサーバーの中身を開く鍵にあたるため、Vetox は他のメンバーが読める場所に投稿することは決してありません。
</Warning>

<Note>
  各サブコマンドは [コマンド管理](/ja/server-management/command-management) から個別に無効化したり、特定のロールやチャンネルに限定したりできます。`/backup create` は管理者に開放しつつ、`/backup load` は完全にオフにする、といった設定もできます。
</Note>

## 作成と確認

<AccordionGroup>
  <Accordion title="/backup create — バックアップを作成する" icon="camera">
    | オプション      | 必須  | 備考                         |
    | ---------- | --- | -------------------------- |
    | `name`     | いいえ | 最大 64 文字。名前を付けると見つけやすくなります |
    | `messages` | いいえ | 0〜250。プランの上限で制限されます        |

    プレミアム対象のセクションは、プランが許す範囲まで自動的に含まれます。返信には新しいバックアップ ID が示され、その後は進捗に合わせて更新されます。バックアップが完了すると、返信には **ID**、それを使う 2 つのコマンド（`/backup info` と `/backup load`）、ダッシュボードのバックアップへのリンクが表示されます。Starter では、メッセージ・メンバーデータ・BAN・添付ファイルが保存されなかったことも併せて示されます。

    <Note>
      手動バックアップはサーバーごとに **10 分**に 1 回、バックアップまたは復元のジョブは 1 度に 1 つだけです。作成には Administrator 権限が必要で、[権限レベル](/ja/server-management/server-backup#権限)が **オーナーのみ** の場合はオーナーだけが作成できます。
    </Note>
  </Accordion>

  <Accordion title="/backup list — バックアップを一覧表示する" icon="list">
    | オプション   | 必須  | 備考                                                               |
    | ------- | --- | ---------------------------------------------------------------- |
    | `page`  | いいえ | 1 から。1 ページあたり 20 行                                               |
    | `scope` | いいえ | **このサーバー**（既定）、**このサーバーのチャンネルバックアップ**、**すべてのサーバーにまたがる自分のバックアップ** |

    新しい順に並びます。自動バックアップとセーフティバックアップには印が付き、ひと目で見分けられます。`scope:mine` は、どのサーバーで作成したものであれ、あなたが作成したすべてのバックアップを取得元のサーバーとともに一覧表示します。よそで取ったバックアップをここへ読み込む前に、その ID を探すための方法です。
  </Accordion>

  <Accordion title="/backup info — バックアップの内容を確認する" icon="circle-info">
    | オプション       | 必須     | 備考                  |
    | ----------- | ------ | ------------------- |
    | `backup_id` | **はい** | 入力に応じてオートコンプリートされます |

    件数、キャプチャ時のオプション、サイズ、最も投稿の多いチャンネル、警告、プランによってロックされているかどうか、そしてダッシュボードのスナップショットビューアーにあるそのバックアップへのリンクが表示されます。ビューアーでは、含まれているチャンネル、ロール、設定、BAN、メンバーをすべて閲覧できます。
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` は、それを取るすべてのサブコマンドでオートコンプリートされるため、ID を手でコピーする必要はありません。候補に出るのは、あなたが使用を許可されているバックアップだけです。
</Tip>

## 復元

<AccordionGroup>
  <Accordion title="/backup load — バックアップを復元する" icon="rotate-left">
    | オプション       | 必須     | 備考                                    |
    | ----------- | ------ | ------------------------------------- |
    | `backup_id` | **はい** | オートコンプリート対応。他のサーバーで作成した自分のバックアップも含みます |
    | `messages`  | いいえ    | 0〜250。プランの上限で制限されます                   |
    | `options`   | いいえ    | 最大 200 文字。下記の構文を参照                    |

    最初に実行した時点では何も復元されません。Vetox は **計画** — いくつのチャンネルとロールが削除され、いくつが作成されるか、そして Vetox 自身のロールより上位にあって手を加えられないロールがあるかどうか — を返信し、**確定** と **キャンセル** のボタンを添えます。ボタンは **60 秒**で期限切れになります。確定を押したときにはじめて、Vetox はセーフティコピーを取得して復元を開始します。

    <Warning>
      バックアップを読み込むと、このサーバーのチャンネルとロールが置き換わります。メンバーがキックされることはありませんが、バックアップ作成後に作られたものは失われます。
    </Warning>

    <Note>
      `/backup load` はサーバーの[権限レベル](/ja/server-management/server-backup#権限)に従います。既定の **管理者は破壊的な操作を実行できない** では、Administrator を持っていてもオーナー以外は拒否されます。
    </Note>

    <Note>
      復元と取り消しには 1 日あたりの上限があります — **サーバーごとに 10 回**、**1 人あたり 20 回**です。`/backup load`、`/backup channel load`、記録された変更の取り消しは、いずれも両方の枠を消費します。失敗した復元の再開は消費しません。
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — 実行中のジョブを停止する" icon="ban">
    オプションはありません。このサーバーで実行中のバックアップまたは復元をキャンセルします。チェックポイントは保持されるため、キャンセルした復元もダッシュボードから再開できます。
  </Accordion>

  <Accordion title="/backup status — 実行中の内容と有効な制限を確認する" icon="heart-pulse">
    オプションはありません。このサーバーで実行中のジョブ（種別、フェーズ、進捗、警告、開始時刻）、または何も実行されていないことを表示します。10 分のクールダウン中であれば次に手動バックアップを作成できる時刻を、復元が **Discord の作成制限** に当たっていればその解除時刻を示します。何も実行されていない場合は、直前のジョブが停止した理由と、ダッシュボードから再開できるかどうかも表示します。
  </Accordion>
</AccordionGroup>

### `options` の構文

`options` はスペース区切りのトークンのリストで、**左から右**の順に適用されます。

| トークン                                                                                                       | 効果              |
| ---------------------------------------------------------------------------------------------------------- | --------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | その項目を**オン**にします |
| いずれかの前に付ける `!` — `!members`                                                                                | その項目を**オフ**にします |
| `*`                                                                                                        | **すべて**をオンにします  |
| `!*`                                                                                                       | **すべて**をオフにします  |

`options` をまったく指定しない場合、Vetox は既定値 **`delete-channels channels delete-roles roles settings`** を使います — メンバー、BAN、ピン留め、絵文字、ステッカーを含まない、構造の完全置換です。

| 例                                        | 結果                                   |
| ---------------------------------------- | ------------------------------------ |
| `options:!* roles delete-roles`          | ロールのみ — 現在のロールを削除し、バックアップのロールを再作成します |
| `options:!* channels roles settings`     | 構造を既存に追加する形で復元 — 何も削除されません           |
| `options:* !members !bans`               | メンバーデータと BAN 以外のすべて                  |
| `options:!delete-channels !delete-roles` | 既定値を追加のみに変えたもの                       |

<Warning>
  **順序が意味を持ちます。** `* !members` はすべてをオンにしてからメンバーをオフにします。`!members *` はメンバーをオフにしてからすべてをオンに戻すので、メンバーも含まれます。トークンのリストは左から右へ読んでください。
</Warning>

<Note>
  トークンがプランの許容範囲を広げることはできません — プランの上限が最後に適用されます。未知のトークンは無視されるのではなく、名前を挙げて拒否されるため、入力ミスが黙って捨てられることはありません。
</Note>

## スケジュール設定

<AccordionGroup>
  <Accordion title="/backup interval — 自動バックアップ" icon="clock">
    | オプション      | 必須     | 備考                                 |
    | ---------- | ------ | ---------------------------------- |
    | `mode`     | **はい** | `on`、`off`、`status` のいずれか          |
    | `interval` | いいえ    | 4 時間、8 時間、12 時間、24 時間、2 日、3 日、1 週間 |
    | `messages` | いいえ    | 0〜250。プランの上限で制限されます                |

    `status` は現在のスケジュールを変更せずに表示します。間隔、保持数、前回と次回の実行、そして最新の自動バックアップの ID が示されます。スケジュールをオンにすると、最初のバックアップが実行される時刻が示されます。

    <Note>
      プランが許すより短い間隔は拒否され、拒否メッセージにはプランの最短間隔が時間単位で示されます。自動バックアップはローテーションし、新しいものが作成されるたびに、プランの保持数を超えた古いものが削除されます。
    </Note>
  </Accordion>
</AccordionGroup>

## チャンネルバックアップ

<AccordionGroup>
  <Accordion title="/backup channel create — 1 つのチャンネルをバックアップする" icon="hashtag">
    | オプション      | 必須  | 備考                             |
    | ---------- | --- | ------------------------------ |
    | `channel`  | いいえ | テキスト、アナウンスメント、スレッド。既定は現在のチャンネル |
    | `messages` | いいえ | 0〜1000。プランの上限で制限されます           |
    | `before`   | いいえ | メッセージ ID。それより**前**のメッセージを保存します |

    <Tip>
      1 回の実行で届く範囲より過去に遡るには `before` を使います。まずチャンネルバックアップを 1 つ作成し、次に 1 つ目が到達した最も古いメッセージ ID を `before` に指定して、もう 1 つ作成します。
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — チャンネルに投稿する" icon="paste">
    | オプション       | 必須     | 備考                         |
    | ----------- | ------ | -------------------------- |
    | `backup_id` | **はい** | オートコンプリートの候補はチャンネルバックアップのみ |
    | `channel`   | いいえ    | 投稿先。既定は現在のチャンネル            |
    | `messages`  | いいえ    | 0〜1000。プランの上限で制限されます       |

    メッセージは古い順に、ピン留めも含めて投稿されます。

    <Note>
      **何も削除されません。** 保存されたメッセージは、そのチャンネルにすでにある内容に追加されます。大きなチャンネルバックアップには時間がかかります — 返信が進捗を随時報告します。
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  チャンネルバックアップには **Basic** 以上が必要です。
</Info>

## バックアップを移動する

<AccordionGroup>
  <Accordion title="/backup export — JSON でダウンロードする" icon="file-export">
    | オプション       | 必須     | 備考          |
    | ----------- | ------ | ----------- |
    | `backup_id` | **はい** | オートコンプリート対応 |

    バックアップを Discord 形式の `.json` ファイルとして、あなたにしか見えない返信に添付して送信します。**8 MB** を超える場合は、代わりにダッシュボードへのリンクが返されます。

    <Note>
      エクスポートに含まれるのはサーバー、ロール、チャンネル、絵文字、ステッカーです。**メッセージ、メンバー、BAN は含まれません** — それらを移すにはバックアップを復元してください。エクスポートはすべてのプランで利用できます。
    </Note>
  </Accordion>

  <Accordion title="/backup import — ファイルからバックアップを作成する" icon="file-import">
    | オプション  | 必須     | 備考                              |
    | ------ | ------ | ------------------------------- |
    | `file` | **はい** | Discord 形式のサーバー `.json`。最大 5 MB |

    Vetox はファイルを検証してバックアップに変換し、その ID を返信します。ほかのバックアップと同じように復元も確認もできます。

    <Warning>
      Discord のサーバー形式に従っていないファイルは、最初に失敗したフィールド名を示したうえで丸ごと拒否されます。Vetox が中途半端に適用することはありません。
    </Warning>

    <Info>
      インポートには **Basic** 以上が必要です。
    </Info>
  </Accordion>
</AccordionGroup>

## 削除

<AccordionGroup>
  <Accordion title="/backup delete — バックアップを 1 つ削除する" icon="trash">
    | オプション       | 必須     | 備考          |
    | ----------- | ------ | ----------- |
    | `backup_id` | **はい** | オートコンプリート対応 |

    まず **確定** を求めます。削除すると、スナップショットとそれとともに保存されたすべてのファイルが、即座かつ永久に取り除かれます。
  </Accordion>

  <Accordion title="/backup purge — すべてのバックアップを削除する" icon="dumpster-fire">
    オプションはありません。**確定** を求めたうえで、このサーバーの**すべて**のバックアップを、保存されたファイルごと削除します。

    <Warning>
      取り消しもゴミ箱もありません。残しておきたいものは、先にエクスポートしてください。
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` と `/backup purge` は、サーバーの[権限レベル](/ja/server-management/server-backup#権限)における破壊的な操作にあたるため、既定のレベルではオーナーだけが実行できます。
</Note>

## 例

```text theme={null}
/backup create name:before-rework
/backup list page:1
/backup list scope:mine
/backup info backup_id:GB7K2QX4M1ZP
/backup load backup_id:GB7K2QX4M1ZP options:!* channels roles
/backup status
/backup interval mode:on interval:12h
/backup channel create channel:#general messages:500
```

## コマンドが拒否されたとき

Vetox は必ず理由を示します。よくあるものは次のとおりです。

| 返信の内容                                                  | 対処                                                                                                       |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| 最近このサーバーでバックアップが作成されました                                | サーバーごとの 10 分の作成クールダウンが明けるのを待ってください                                                                       |
| 別のバックアップジョブがすでに実行中です                                   | 完了を待つか、`/backup cancel` を実行してください                                                                        |
| 本日の復元・取り消しの上限に達しました                                    | このサーバーまたはあなたのアカウントが、1 日の枠（サーバーごと 10 回 / 1 人あたり 20 回）を使い切っています。明日また試してください                                |
| プランのバックアップ上限に達しました                                     | 1 つ削除するか、アップグレードしてください                                                                                   |
| このバックアップはプランの上限を超えています                                 | ダウングレードによりロックされています。新しいバックアップを削除するか、アップグレードしてください                                                        |
| この操作はサーバーのバックアップ権限で許可された人しか実行できません                     | このサーバーの権限レベルでは、この操作はオーナーに限られています。オーナーが実行するか、設定 → 権限 でレベルを変更してください                                        |
| その間隔はプランが許す長さより短いです                                    | メッセージに示された最短間隔を使うか、アップグレードしてください                                                                         |
| 選択されたオプションのいずれかが無効です                                   | 未知の `options` トークンです — 上記の構文と照らし合わせてください                                                                 |
| Vetox に必要な権限がありません                                     | Vetox に Administrator を付与し、そのロールを復元対象のロールより上に移動してください                                                    |
| Discord がボットに許すのは 48 時間あたり 250 ロールまたは 500 チャンネルの作成までです | Discord 自身の作成制限です。解除時刻は `/backup status` に表示されます。待って再開するか、`options:!delete-roles !roles` を付けて読み込み直してください |
| そのファイルは有効な Discord サーバーエクスポートではありません                   | インポートしたファイルが Discord の形式に一致していません                                                                        |
| サーバーバックアップは一時的に利用できません                                 | メンテナンスのため停止しています。バックアップはそのままです                                                                           |

## 関連

<CardGroup cols={2}>
  <Card title="サーバーバックアップ" icon="server" href="/ja/server-management/server-backup">
    機能の全体 — 復元、スケジュール、変更の記録、タイムマシン。
  </Card>

  <Card title="マイバックアップ" icon="box-archive" href="/ja/members/my-backups">
    すべてのサーバーにまたがるあなたのバックアップ。
  </Card>

  <Card title="コマンド管理" icon="sliders" href="/ja/server-management/command-management">
    各サブコマンドを個別に無効化・制限します。
  </Card>

  <Card title="コマンドリファレンス" icon="terminal" href="/ja/commands/overview">
    すべてのコマンドに共通する権限とクールダウンの仕組み。
  </Card>
</CardGroup>