ECS:在 ECS 中的 CAS 保留
Summary: 本文說明在 ECS 中的 CAS 保留。當中也說明 CAS 應用程式的進階保留:事件式保留、合法持有以及最小/最大調節器
Instructions
這是 ECS 資料存取指南的摘錄 可在此處找到和下載的內容:ECS 應用裝置產品頁面
在 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 的詳細資訊。
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 進行一次呼叫。 |
Additional Information
以下是 ECS 資料存取指南中詳述的 CAS 相關主題,並將分至不同的 KB 中:
- CS:在 ECS 中的 CAS 保留 - KB 538782
- CAS 保留
- CAS 應用程式的進階保留:事件式保留、合法持有以及最小/最大調節器
- ECS:設定 CAS 的命名空間保留原則 - KB 538786
- ECS:設定 CAS 的容器 ACL - KB 538789
- ECS:支援 CAS 使用者的 ECS 管理 API - KB 538790
- ECS:CAS (Centera) SDK 錯誤代碼 - KB 427034