文件

不正確的版本清除引數會清除AEM中所有版本的頁面

Last update: Mon Dec 01 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

在Adobe Experience Manager (AEM)中設定版本清除時，有三個引數互動：

  • maxAgeDays — 要保留的版本的最長存留期（以天為單位）；-1表示沒有存留期限制
  • minNumberVersions — 一律保留的頁面最低版本
  • maxNumberVersions — 要保留的頁面最大版本

未正確設定的引數會清除頁面的所有歷史版本，只留下最新版本。 本文概述不同使用案例中的正確設定，協助您防止意外清除。

說明 description

環境

Adobe Experience Manager (AEM)

問題

設定錯誤的版本清除OSGi引數會導致刪除所有頁面版本。

範例情境：

您想要保留10個版本（無論使用年限為何），並依照下列方式設定引數：

maxAgeDays= -1
minNumberVersions= 0
maxNumberVersions= 10

但是，此設定會導致清除所有版本。

原因

  • 如果期限限制(maxAgeDays)設為–1，則不會根據版本的期限執行清除。 在這種情況下，minNumberVersions和maxNumberVersions引數會決定要保留哪些版本。
  • 如果minNumberVersions設為0 （或小於1），表示可以清除所有版本。 maxNumberVersions引數已變成不相關，因為未設定任何期限限制。
  • 除非您明確想要清除所有版本，否則最佳做法是將minNumberVersions設定為大於1，無論使用年限為何。

注意：目前版本一律保留。

解決方法 resolution

若要保留10個版本（無論使用年限為何），請使用以下設定：

maxAgeDays= -1
minNumberVersions= 10
maxNumberVersions= 0

在此情況下，maxNumberVersions會被忽略，因為保留是由minNumberVersions所控管。

請參閱AEM使用手冊中的版本管理員，瞭解更新版本清除引數的說明。

使用案例

在設定這些引數之前，請先檢閱以下一些使用案例，以避免清除頁面的所有版本。

maxAgeDays
minNumberVersions
maxNumberVersions
結果
-1
0
10
即使有10個版本比1天舊，此設定仍會清除所有版本。 這是因為 — minNumberVersions 設定為0 （或小於1），表示應清除所有版本。

若未設定期限限制，maxNumberVersions引數會變得無關緊要)。
10
0
10
如果所有版本都在10天之前，但未指定minNumberVersions 引數，則會清除所有版本，因為沒有任何版本在10天限制內。

如果有5個版本少於10天、10個版本超過10天，以及minNumberVersions=0，則會保留5個版本。
10
0
0
如果所有版本都早於10，則會清除所有版本，因為沒有要保留的最低版本數量。 在此情況下也沒有maxNumberVersions。

即使有5個版本少於10天，所有版本都會被清除。
-1
-1
10
此設定會清除所有版本，因為沒有要保留的版本數目下限。 若未設定保留時間限制，maxNumberVersions引數會變得無關緊要。
10
-1
10
如果所有版本都超過10天，則會永久刪除所有版本，因為沒有要保留的最低版本數量。

當沒有版本少於或等於10天時，maxNumberVersions引數會變得無關緊要。

如果有5個版本少於10天、10個版本早於10天，以及minNumberVersions=0，則只會保留少於10天的5個版本。
10
-1
0
如果所有版本都超過10天，則會永久刪除所有版本，因為沒有要保留的最低版本數量。 在此情況下，maxNumberVersions引數不相關。

如果有5個版本少於10天，10個版本超過10天，且minNumberVersions= 0，則會保留5個版本。
10
5
5
如果所有5個版本都在10天之前，則會保留所有5個版本，因為minNumberVersions設定為5。

如果有25個版本超過10天，則僅保留最後5個版本，因為最小值和最大值皆設為5。
10
5
10
如果10天內有5個版本，而10個版本比10天舊（共15個版本），則會保留最後10個版本，因為minNumberVersions 設為5個，maxNumberVersions設為10個。 在此，最小值和最大值引數都很重要。

相關閱讀

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f