Confluence Cloud で古いページバージョンを削除する方法

English · 日本語 · Deutsch

Kayabyte 著 · 更新日 2026年11月11日

結論: Confluence Cloud には、ページバージョンを一括で削除する機能も、最新の N 件だけを残す設定もありません。どちらも未対応の要望です (CONFCLOUD-46541、CONFCLOUD-27701。2026 年 11 月 11 日時点でいずれも Gathering Interest)。ページ履歴から 1 件ずつ削除する、ページの添付ファイル一覧から古い添付ファイルのバージョンを削除する、または REST API をスクリプトで使う方法があります。Pruner: Version History Cleanup for Confluence は、ページと添付ファイルに「最新の N 件を残す」ルールをプレビュー付きで適用します。

何年も編集されてきたページには数百のバージョンがあることもあり、添付ファイルのバージョンはそれぞれがファイルの完全なコピーです。このガイドでは、Confluence Cloud だけでできること、各方法の限界、そして保持ルールに必要なことを説明します。

方法 1: ページ履歴から 1 件ずつ削除する

1. ページを開き、ページ履歴 (バージョンの一覧) を開きます。
2. 不要なバージョンの横にある 削除 を選択し、確定します。

知っておくべきこと:

• 削除 が表示されない場合は、そのスペースで必要な権限がない可能性があります。スペース管理者に確認してください。
• 削除したバージョンはごみ箱に入らず、復元できません (Atlassian: ページ履歴)。
• 削除後にバージョン番号が変わることがあるので、番号が変わらない前提にしないでください。
• 1 回のクリックで削除できるのは 1 ページの 1 バージョンだけです。CONFCLOUD-46541 は、数百のバージョンを持つページを抱えた人からの、まさにこの理由による要望です。

方法 2: 古い添付ファイルのバージョンを削除する

容量の大半は添付ファイルが占めていることが多く、変更したファイルをアップロードするたびにバージョンが増えます。

1. ページを開き、フローティング ツールバーの 詳細を表示 から 添付ファイル を選択します。
2. 添付ファイルを展開してバージョンを表示します。
3. バージョンの横にある 削除 を選択し、確定します。

特定のバージョンを削除するには スペース管理者 権限が必要です。ファイル全体の削除は 添付ファイルの削除 権限で可能です。削除したバージョンは復元できません (Atlassian: アップロードしたファイルの管理)。

こちらも 1 ページの 1 添付ファイルずつの作業です。

方法 3: REST API をスクリプトで使う

Confluence Cloud には、ページの 1 バージョンを削除する REST 呼び出しがあります: DELETE /wiki/rest/api/content/{id}/version/{versionNumber} (Confluence Cloud REST API、コンテンツ バージョン)。スペースを整理するスクリプトは次のように動きます。

1. スペース内のページを一覧し (GET /wiki/api/v2/spaces/{id}/pages)、ページネーションのリンクをたどります。
2. 各ページのバージョンを一覧します (GET /wiki/api/v2/pages/{id}/versions)。
3. 削除するバージョンを決めます。たとえば「最新 10 件を除き、かつ 90 日より古いもの」。
4. 上の呼び出しで削除します。削除後にバージョン番号が変わることがあるため、呼び出しのたびに一覧を読み直すか、常に最も古いものから削除します。
5. 添付ファイルのバージョンにも同じことを行います。

スクリプトの限界:

• プレビューがない。 削除したバージョンは復元できないので、何が消え、どれだけ容量が空くかを先に示すドライランが必要です。
• 権限。 特定の人に制限されたページは、スクリプトを実行するアカウントが閲覧できる場合にしか見えません。
• レート制限と規模。 大きなサイトでは呼び出しが多くなり、ページング、再試行、中断からの再開が必要です。
• 一度きり。 バージョンはまた溜まるので、誰かが再実行するか、どこかで動かし続ける必要があります。

保持ルールに必要なこと

どの方法を使う場合も、先に次を決めます。

• 各ページと各添付ファイルについて 何件のバージョンを残すか。最新のものは決して削除しません。
• 最低経過日数。 ページのバージョンが N 件を超えていても、今週のバージョンは残します。
• 対象のスペース。 法務、規程、監査のスペースは全履歴が必要なことがよくあります。
• 最初の削除の前に件数と容量を示す プレビュー。最初は緩いルール (たとえば 20 件を残し、180 日より古いものだけ削除) で始め、後から厳しくします。
• 繰り返すかどうか。 1 回だけの整理か、毎晩の整理か。

Pruner: Version History Cleanup for Confluence

Pruner は、私たちがこの目的のために作っているアプリです。Confluence Cloud のページと添付ファイルのバージョンに保持ルールを適用します。

• 各ページと各添付ファイルの最新 N 件を残し、必要に応じて指定日数より古いバージョンだけを削除し、対象のスペースを選びます (空欄ならすべてのスペース)。
• プレビュー では、ルールが削除するページと添付ファイルの古いバージョンの数、添付ファイルのバージョンが使っている容量、古いバージョンが最も多いページが表示されます。この段階では何も削除されません。
• 手動の整理は Confluence 管理者が確定します。夜間の自動整理は任意で、初期状態ではオフです。
• 現在のバージョンとページの内容は変更されません。ブログ投稿、コメント、ページ全体には触れません。
• 特定の人に制限されたページはアプリから見えないため、夜間の整理では対象外です。それらを閲覧できる管理者が実行する手動の整理では対象になります。
• Pruner は Atlassian Forge 上で動作し、Atlassian の外部への通信は行いません。

削除したバージョンは復元できないので、まずプレビューを使ってください。アプリの画面は英語です。Pruner は Atlassian Marketplace で入手できます。

よくある質問

Confluence Cloud で古いページバージョンを一括削除できますか？ いいえ。一括削除の機能も、最新のバージョンだけを残す設定もなく、どちらも未対応の要望です (CONFCLOUD-46541、CONFCLOUD-27701)。1 件ずつ削除するか、REST API をスクリプトで使います。

削除したページバージョンは復元できますか？ いいえ。削除したバージョンはごみ箱に入らず、復元できません。削除した添付ファイルのバージョンも同様です。

古い添付ファイルのバージョンは誰が削除できますか？ スペース管理者権限を持つ人です。ファイル全体の削除には「添付ファイルの削除」権限が必要です。

バージョンを削除したらバージョン番号が変わったのはなぜですか？ 削除後にバージョン番号が変わることがあります。残った各バージョンの内容は変わりません。

バージョンを削除するとすぐに容量が空きますか？ すぐとは限りません。Atlassian によると、容量の表示は 4 時間ごとにしか更新されません。

Confluence および Atlassian は Atlassian の商標です。Kayabyte は独立した開発者であり、Atlassian と提携しておらず、Atlassian による承認も受けていません。