ECS：在 ECS 中的 CAS 保留

在 ECS 中的 CAS 保留

CAS C-Clip 可能有一個管理時間長度的保留期間。在應用程式可以將其刪除前，相關聯物件會保留在 ECS 儲存裝置中。


保留期間

CAS 應用程式會在 C-Clip 中為物件指派保留期間。

例如，如果財務文件必須自其建立日期起保留三年，則會在與該財務文件相關聯的 C-Clip 中指定
三年的保留期。
也可以指定文件會無限期保留。

保留原則 (保留類別)

注意：Centera 保留類別的概念會對應至 ECS 中的保留原則，此
說明文件會使用保留原則。

保留原則可讓您擷取保留使用案例並套用至 C-Clip。例如，
不同類型的文件可能會有不同的保留期間。您可能需要
下列保留期間：

• 財務：3 年
• 法律：5 年
• 電子郵件：6 個月

透過變更原則，將保留原則套用至多個 C-Clip 時。保留
期間會變更原則適用的所有物件。

保留原則與 ECS 中的命名空間相關聯，並由 CAS
應用程式辨識為保留類別。
 

ECS 容器層級保留和 CAS

容器層級保留不是 Centera 中的預設集區保留。在 ECS 中，CAS 預設保留會
持續為零。
 

寫入物件中的預設保留期間在法規遵循
命名空間中沒有物件層級保留。

從 ECS 3.0 開始，當應用程式在法規遵循命名空間中將沒有物件保留的 C-Clip 寫入至 ECS CAS
容器，且該容器具有保留值 (例如 6 個月)，
則會指派無限 (-1) 的預設保留期間給 C-Clip。C-Clip 永遠無法
刪除，因為它們的有效保留期間是兩者之間最長的保留期間：
容器層級保留期間和預設物件層級保留。
 

CAS 優先

將多個保留期間套用至 ECS 中的 CAS 物件時，無論如何套用保留，具有
較高值的保留期間均為優先。
 

如何套用 CAS 保留

您可以定義 ECS 入口網站或 ECS 管理
API 中的命名空間保留原則。請參閱設定命名空間保留原則。

您的外部 CAS 應用程式可在 C-Clip 建立期間
指派固定保留期間或保留原則。

透過 API 套用保留期間時，請以秒為單位指定週期。

注意：ECS CAS 會針對所有保留相關計算使用 C-Clip 的建立時間，
而非遷移時間。

如何使用 ECS 管理 API 建立保留原則。

您可以使用 ECS 建立保留期間和原則，摘要如下所述
。

方法	說明
PUT /object/bucket/{bucketName}/retention	容器的保留值定義了套用至容器內每個物件的 強制 保留期間。如果您設定保留期間為 1 年，則容器內的物件 一年內無法刪除。
GET /object/bucket/{bucketName}/retention	傳回目前為指定容器設定的 保留期間。
POST /object/namespaces/namespace/{namespace}/ retention	對於命名空間，保留設定作用與原則一樣， 其中每個原則都是一個<名稱>：<保留期間> 配對。 您可以為 命名空間定義數個保留原則，並可依名稱將原則指派給 命名空間內的物件。如此可讓您透過變更對應的原則， 來變更 已獲指派相同原則的 一組物件的保留期間。
PUT /object/namespaces/namespace/{namespace}/ retention/{class}	更新與命名空間相關聯保留期間的期間 。
GET /object/namespaces/namespace/{namespace}/ retention	傳回為命名空間定義的保留原則。

您可以在 ECS 資料存取指南的 ECS 管理 REST API
簡介中找到 ECS 管理 API 的詳細資訊。線上參考資料如下：ECS API 參考資料。

CAS 應用程式的進階保留：事件式保留、合法持有以及最小/最大調節器

說明 ECS 支援的 CAS API 中可用的進階保留功能。

客戶應用程式會使用 CAS API 來啟用保留策略。當 CAS 工作負載
遷移至 ECS 時，ECS 在察覺 CAS API 功能後可讓客戶應用程式繼續
處理已遷移資料。在 ECS 中，下列進階保留管理 (ARM) 功能
可在沒有個別授權的情況下提供：

• 事件式保留：可透過其 C-Clip 設定物件，以便在 CAS 應用程式收到指定事件時套用 (觸發) 保留期間
  或保留原則。
• 合法持有：如果 CAS 應用程式已透過其 C-Clip 對某個物件套用
  合法持有，則可防止將該物件刪除。CAS 應用程式可透過建立和套用唯一合法持有 ID，對物件套用最多 100 個
  合法持有。
• 最小/最大調節器：系統管理員可設定固定保留期間或變數保留期間的
  容器層級限制。設定變數保留期間可支援
  事件式保留。在 ECS 中，系統或命名空間系統管理員可設定 ECS 入口網站
  的值。程式設計師可以使用 ECS 管理 API 來設定值。

注意：使用任何已遷移
至 ECS 的命名方案寫入的舊版 CAS 資料支援 ARM。

CAS 容器層級保留最小/最大調節器

從 ECS 入口網站中找到 CAS 容器，然後選取編輯。下方畫面
上顯示的所有功能皆為僅限 CAS 功能，但容器保留期間功能除外。容器保留
期間是所有 ECS 容器類型支援的標準 ECS 容器保留功能。

下表說明 CAS 容器保留功能。
 

功能	說明
強制執行保留	如果此功能已開啟，則無法在沒有 保留資訊 (期間或原則) 時建立任何 CAS 物件。嘗試儲存此類物件時會傳回錯誤。如果已開啟， 即使是在符合法規遵循 的環境下，也可不設定容器保留期間。 注意：當 CE+ 模式 Centera 遷移至 ECS 時，容器上的強制執行保留預設為開啟 。
容器保留 期間	如果指定了容器保留期間，在同時有 容器層級和物件層級保留期間下，則會強制執行較長的期間。在已啟用法規遵循的 環境中，除非強制執行物件中的保留資訊， 否則必須使用容器保留期間。但是，設定完成後，即使強制執行物件中的保留資訊，也無法 重設容器保留期間。
最小固定 保留期間	此功能可管理物件中指定的保留期間。如果物件的保留 期間超出此處指定的界限，則寫入物件的嘗試會失敗。使用保留原則時，不會強制執行最小/最大設定。為最小固定保留期間選取 無限表示所有保留值都必須是無限的。選取最大固定保留期間代表 沒有上限。最小/最大 保留限制會套用至寫入容器的任何 C-Clip。如果任何 SDK 型第三方工具將某個 Clip 遷移 ，保留應為界限內，否則系統會 擲出錯誤。
最大固定 保留期間
最小變數 保留期間	此功能使用事件式 保留 (EBR) 管理在物件中指定的變數保留期間。在 EBR 中會設定基本保留期間，而程式設計的觸發功能 可在發出觸發時增加保留期間。如果物件的新 保留期間超出此處指定的界限，則回應觸發的寫入物件嘗試 會失敗。使用保留原則時，不會 強制執行最小/最大設定。為最小變數保留期間選取無限表示所有保留 值都必須是無限的。選取最大變數保留期間代表 沒有上限。最小/最大保留限制會套用至寫入 容器的任何 C-Clip。如果任何 SDK 型第三方工具將某個 Clip 遷移，保留應為 界限內，否則系統會擲出錯誤。
最大變數 保留期間

注意：如果系統管理員或程式設計師尚未設定固定和
變數保留期間的任何值，ECS 管理 API 的 get 功能將不會傳回
最小/最大設定的值。C-Clip 中的強制保留資訊會傳回錯誤的預設
值。
 

事件式保留

事件式保留 (EBR) 是一項指示，指定在事件前
及事件後的指定期間內，無法刪除某個記錄。在 CAS 中，EBR 是 C-Clip，具有指定的基本
保留期間或保留原則，以及應用程式定義的觸發，可在發出觸發時設定較長
保留期間。保留期間僅在發出觸發時才開始。
當為 EBR 標示 C-Clip 時，除非使用授權刪除
，否則無法在事件之前將其刪除。

使用 EBR 時，C-Clip 生命週期如下：

• 建立：應用程式會建立新的 C-Clip，並將其標記為在 EBR 下。應用程式
  可以提供固定保留期間，作為最小保留期間，且必須提供
  事件式保留期間或原則。
• 觸發事件：應用程式會觸發事件，這是事件式
  保留期間或保留原則的起點。如果比 C-Clip 建立時
  指定的保留期間更長，應用程式可以指派新的事件式
  保留期間。
• 刪除：當應用程式嘗試刪除 C-Clip 時，必須符合下列條件：
  原則 (命名空間) 保留已到期
  容器保留已到期
  修正保留已到期
  此事件已觸發
  在建立時設定的 EBR 以及事件已到期時任何後續的變更 (延伸)

下圖顯示 EBR 底下 C-Clip 的三個可能情況：

• C1 的固定或最小保留在觸發事件前已到期。
• C2 的固定或最小保留將會在 EBR 到期前到期。
• C3 的固定或最小保留將會在 EBR 到期後到期。

 

若為不相容的命名空間，授權刪除命令可覆寫 EBR 的固定和變數
保留。

套用 EBR 保留時，必須遵守變數
保留期間的最小/最大調節器設定。

此表顯示事件式保留的 CAS API 功能

功能	說明
FPClip_EnableEBRWithClass	此功能可設定 C-Clip 以符合接收日後活動的資格，並可 在 C-Clip 建立期間將事件式保留 (EBR) 類別指派給 C-Clip 。
FPClip_EnableEBRWithPeriod	此功能可設定 C-Clip 以符合接收日後活動的資格，並可 在 C-Clip 建立期間將事件式保留 (EBR) 期間指派給 C-Clip 。
FPClip_IsEBREnabled	此功能會傳回布林值，以指出 是否已啟用事件式保留 (EBR) 的 C-Clip。
FPClip_GetEBRClassName	此功能會擷取事件式保留 (EBR) 的名稱。 已指派給 C-Clip 的原則。
FPClip_GetEBREventTime	當觸發該 C-Clip 的事件式 保留 (EBR) 事件時，此功能會傳回 C-Clip 上設定的事件時間。
FPClip_GetEBRPeriod	此功能會傳回與 C-Clip 相關聯之事件式 保留 (EBR) 期間的值 (以秒為單位)。
FPClip_TriggerEBREvent	此功能會觸發啟用事件式 保留 (EBR) 的 C-Clip 事件。
FPClip_TriggerEBREventWithClass	此功能會觸發啟用事件式 保留 (EBR) 的 C-Clip 事件，並將新的 EBR 原則指派給 C-Clip。
FPClip_TriggerEBREventWithPeriod	此功能會觸發啟用事件式 保留 (EBR) 的 C-Clip 事件，並將新的 EBR 期間指派給 C-Clip。

 

 

合法持有

合法持有可讓 CAS 應用程式暫時避免刪除 C-Clip。合法持有
對於受到官方調查、傳票或查詢約束的資料是十分實用的，而且在調查結束之前不可將其
刪除。一旦不需要持有資料，應用程式即可將合法持有解除
，並恢復正常保留行為。CAS 應用程式
會在 C-Clip 層級放置及移除合法持有。

注意：即使是授權刪除也無法刪除在合法持有下的 C-Clip。

一個 C-Clip 可列在多個合法持有下。應用程式必須產生唯一的合法
持有 ID，並能夠追蹤與 C-Clip 相關聯的特定合法持有。應用程式
無法查詢此資訊的 C-Clip。只有一個功能可判定 C-Clip 的合法
持有狀態。如果 C-Clip 上有一或多個合法持有，此功能
會傳回 true，否則，則為 false。

使用合法持有時，C-Clip 生命週期如下：

• 建立：應用程式會建立新的 C-Clip，並提供固定及/或事件式
  保留期間。
• 設定合法持有：應用程式會將 C-Clip 暫時停用。此應用程式可能與撰寫 C-Clip 的應用程式不同
  。
• 解除合法持有：應用程式解除 C-Clip。此應用程式可能與設定合法持有或撰寫 C-Clip 的應用程式不同
  。
• 刪除：當應用程式嘗試刪除 C-Clip 時，必須符合下列條件：
  C-Clip 上沒有其他未處理的合法持有。
  原則保留已到期。
  標準容器保留已到期。(標準容器保留適用於所有 ECS 物件類型，但不建議 CAS 使用。)
  固定保留期間已到期 (僅限 CAS 功能)。
  事件式保留已到期 (僅限 CAS 功能)。

下圖顯示置於合法持有下的 C-Clip 的三個可能情況：

• C1 的固定保留在置於合法持有下時已到期。
• C2 的固定保留在合法持有期間已到期。
• C3 的固定保留將會在合法持有解除後到期。

可指派多個合法持有至 C-Clip。如果是這種情況，每個合法持有都需要
個別的 API 呼叫，包含合法持有的唯一識別碼。

注意：合法持有 ID 的大小上限為 64 個字元。每個 C-Clip 合法持有 ID 的上限
為 100 個。CAS API 會強制執行這些限制。

此表顯示合法持有的 CAS API 功能
 

功能	說明
FPClip_GetRetentionHold	此功能可判 C-Clip 的合法持有狀態，並 傳回 true 或 false。
FPClip_SetRetentionHold	此功能會設定或重設 C-Clip 上的合法持有。針對 多個合法持有，請為 每個合法持有提供唯一合法持有 ID。針對多個合法持有，請為每個 ID 進行一次呼叫。

以下是 ECS 資料存取指南中詳述的 CAS 相關主題，並將分至不同的 KB 中：

• ECS：在 ECS 中設定 CAS 支援 - KB 538783
  • 在 ECS 中設定 CAS 支援
  • 冷儲存裝置
• ECS：CAS 法規遵循 - KB 538784
  • 平台強化與法規遵循
  • 法規遵循和保留原則
  • 法規遵循專員
• ECS：在 ECS 中的 CAS 保留 - KB 538782
  • CAS 保留
  • CAS 應用程式的進階保留：事件式保留、合法持有以及最小/最大調節器
• ECS：設定 CAS 的命名空間保留原則 - KB 538786
• ECS：CAS 使用者與容器管理最佳實務 - KB 478327
  • 為 CAS 使用者建立和設定容器
  • 設定 CAS 物件使用者
• ECS：設定 CAS 的容器 ACL - KB 538789
• ECS：支援 CAS 使用者的 ECS 管理 API - KB 538790
• ECS：內容位址儲存 (CAS) SDK API 支援 - KB 538791
• ECS：CAS (Centera) SDK 錯誤代碼 - KB 427034