ECS: Retention CAS in ECS

Retention CAS in ECS

Una C-Clip CAS può avere un periodo di retention che regola il periodo di tempo. L'object associato viene conservato nello storage ECS prima che un'applicazione possa eliminarlo.


Periodi di retention

I periodi di retention vengono assegnati nella C-Clip per l'object dall'applicazione CAS.

Ad esempio, se un documento finanziario deve essere conservato per tre anni dalla data di creazione,
nella C-Clip associata al documento finanziario viene specificato un periodo di retention di tre anni. È
inoltre possibile specificare che il documento venga conservato a tempo indeterminato.

Policy di retention (classi di retention)

Nota: Il concetto Centera delle classi di retention esegue la mappatura alle policy di retention in ECS. Questa
documentazione utilizza policy di retention.

Le policy di retention consentono di acquisire e applicare casi d'uso di retention alle C-Clip. Ad esempio,
diversi tipi di documenti potrebbero avere periodi di retention diversi. Potrebbero essere necessari i
seguenti periodi di retention:

• Documenti finanziari: 3 anni
• Documenti legali: 5 anni
• E-mail: 6 mesi

Quando una policy di retention viene applicata a più C-Clip, modificando la policy il periodo di retention
cambia per tutti gli object a cui si applica la policy.

Le policy di retention sono associate ai namespace in ECS e vengono riconosciute dall'applicazione
CAS come classi di retention.
 

Retention a livello di bucket ECS e CAS

La retention a livello di bucket non è la retention del pool predefinita in Centera. In ECS, la retention predefinita di CAS è
sempre zero.
 

Periodo di retention predefinito in object scritti senza retention a livello di object nei namespace
di conformità.

A partire da ECS 3.0, quando un'applicazione scrive C-Clip senza object retention su un bucket CAS ECS
in un namespace di conformità e il bucket ha un valore di retention (ad esempio, 6 mesi),
il periodo di retention predefinito a infinito (-1) verrà assegnato alle C-Clip. Le C-Clip non possono mai
essere eliminate, poiché il loro periodo di retention effettivo è il valore maggiore tra
il periodo di rentention a livello di bucket e la retention a livello di object predefinita.
 

Priorità CAS

Quando vengono applicati più periodi di retention a un object CAS in ECS, il periodo di retention con il
valore più alto ha la precedenza indipendentemente da come è stata applicata la retention.
 

Come applicare la retention CAS

È possibile definire policy di retention per i namespace nel portale ECS o con l'API di
gestione ECS. Vedere Configurazione delle policy di retention del namespace (in inglese).

L'applicazione CAS esterna può assegnare un periodo di retention fisso o una policy di retention alla C-Clip
in fase di creazione.

Quando si applicano periodi di retention tramite API, specificare il periodo in secondi.

Nota: CAS ECS richiede il tempo di creazione della C-Clip per tutti i calcoli correlati alla retention e
non il tempo di migrazione.

Come creare policy di retention con l'API di gestione ECS.

È possibile creare periodi e policy di retention utilizzando ECS, di cui è illustrato un riepilogo
di seguito.

Metodo	Descrizione
PUT /object/bucket/{bucketName}/retention	Il valore di retention per un bucket definisce un periodo di retention obbligatorio che viene applicato a ogni object all'interno di un bucket. Se si imposta un periodo di retention di 1 anno, un object dal bucket non può essere eliminato per un anno.
GET /object/bucket/{bucketName}/retention	Restituisce il periodo di retention attualmente impostato per un bucket specificato.
POST /object/namespaces/namespace/{namespace}/ retention	Per i namespace, l'impostazione di retention agisce come una policy, in cui ogni policy è una coppia<Name>:<Retention period>. È possibile definire diverse policy retention per un namespace e assegnare una policy, in base al nome, a un object all'interno del namespace. Ciò consente di modificare il periodo di retention di un set di object a cui è assegnata la stessa policy modificando la policy corrispondente .
PUT /object/namespaces/namespace/{namespace}/ retention/{class}	Aggiorna il periodo per un periodo di retention associato a un namespace.
GET /object/namespaces/namespace/{namespace}/ retention	Restituisce la policy di retention definita per un namespace.

Per ulteriori informazioni sull'API di gestione ECS, consultare l'introduzione
API REST di gestione ECS (in inglese) in ECS Data Access Guide. Il riferimento online è qui: Riferimento API ECS (in inglese).

Retention avanzata per le applicazioni CAS: retention basata su eventi, controversia e limite min/max

Descrive le funzionalità di retention avanzate disponibili nell'API CAS supportate da ECS.

Le applicazioni dei clienti utilizzano l'API CAS per abilitare le strategie di retention. Quando i carichi di lavoro CAS vengono
migrati a ECS, l'awareness ECS delle funzionalità API CAS consente alle applicazioni del cliente di continuare
a lavorare sui dati migrati. In ECS, le seguenti funzionalità ARM (Advanced Retention Management)
sono disponibili senza una licenza separata:

• Retention basata su eventi: la possibilità di configurare un object tramite le relative C-Clip per applicare (attivare) un
  periodo di retention o una policy di retention quando l'applicazione CAS riceve un evento specificato.
• Controversia: la possibilità di impedire l'eliminazione di un object se l'applicazione CAS ha applicato una
  controversia all'object tramite C-Clip. L'applicazione CAS può applicare fino a 100
  controversie a un object mediante la creazione e l'applicazione di ID di controversia univoci.
• Limite minimo/massimo: possibilità per un amministratore di impostare limiti a livello di bucket per un periodo
  di retention fisso o un periodo di retention variabile. Un periodo di retention variabile è impostato per supportare
  la retention basata su eventi. In ECS, gli amministratori di sistema o del namespace possono impostare i valori con il portale
  ECS. I programmatori possono utilizzare l'API di gestione ECS per impostare i valori.

Nota: ARM è supportato per i dati CAS legacy scritti con qualsiasi schema di denominazione migrato
a ECS.

Limite minimo/massimo per la retention a livello di bucket CAS

Dal portale ECS, individuare un bucket CAS e selezionare Edit. Tutte le funzionalità mostrate nella schermata
seguente sono funzionalità esclusive di CAS, ad eccezione della funzionalità Bucket Retention Period. Bucket Retention
Period è la funzionalità di retention del bucket ECS standard supportata su tutti i tipi di bucket ECS.

Le funzionalità di retention dei bucket CAS sono illustrate nella tabella seguente.
 

Funzione	Descrizione
Enforce Retention	Se questa funzionalità è attivata, non è possibile creare alcun object CAS senza informazioni di retention (periodo o policy). Un tentativo di salvare un object di questo tipo restituisce un errore. Se è attivata, non è possibile configurare un Bucket Retention Period neppure in un ambiente abilitato per la conformità. Nota: Quando un Centera in modalità CE+ viene migrato in ECS, l'opzione Enforce Retention è attivata per impostazione predefinita nel bucket.
Bucket Retention Period	Se viene specificato un periodo di retention del bucket, viene applicato il periodo più lungo se sono presenti sia un periodo di retention a livello di bucket che un periodo di retention a livello di object. In un ambiente abilitato per la conformità, Bucket Retention Period è obbligatorio a meno che non vengano applicate le informazioni di retention nell'object. Tuttavia, una volta configurato, il Bucket Retention Period non può essere reimpostato anche quando vengono applicate le informazioni di retention nell'object.
Minimum Fixed Retention Period	Questa funzionalità regola i periodi di retention specificati negli object. Se il periodo di retention di un object non rientra nei limiti specificati qui, il tentativo di scrittura dell'object ha esito negativo. Utilizzando le policy di retention, le impostazioni min/max non vengono applicate. Selezionando Infinite per Minimum Fixed Retention Period, tutti i valori di retention devono essere infinito. Selezionando Infinite per Maximum Fixed Retention Period, significa che non c'è un limite massimo. I vincoli di retention min/max vengono applicati a qualsiasi C-Clip scritta in un bucket. Se una clip viene migrata da uno strumento di terze parti basato su SDK, la retention deve essere entro i limiti, in caso contrario viene restituito un errore.
Maximum Fixed Retention Period
Minimum Variable Retention Period	Questa funzionalità regola i periodi di retention variabili specificati negli object utilizzando la retention basata su eventi (EBR). In EBR, viene impostato un periodo di retention di base e la funzione di attivazione programmata può aumentare il periodo di retention quando la condizione di attivazione si attiva. Se il nuovo periodo di retention di un object non rientra nei limiti specificati qui, il tentativo di scrittura dell'object in risposta al trigger ha esito negativo. Quando si utilizzano policy di retention, le impostazioni min/max non vengono applicate. Selezionando Infinite per Minimum Variable Retention Period, tutti i valori di retention devono essere infinito. Selezionando Infinito per Maximum Variable Retention Period, significa che non c'è un limite massimo. I vincoli di retention min/max vengono applicati a qualsiasi C-Clip scritta in un bucket. Se una clip viene migrata da uno strumento di terze parti basato su SDK, la retention deve essere entro i limiti, in caso contrario viene restituito un errore.
Maximum Variable Retention Period

Nota: Se l'amministratore di sistema o il programmatore non ha impostato alcun valore per i periodi di retention fissi e
variabili, la funzione di attivazione dell'API di gestione ECS non restituirà valori per
le impostazioni min/max. La funzione Enforce Retention Information in C-Clip restituirà un valore predefinito
di False.
 

Retention basata su eventi

EBR (Event-Based Retention) è un'istruzione che specifica che un record non può essere eliminato prima di un
evento e durante un periodo di tempo specificato dopo l'evento. In CAS, EBR è una C-Clip con un periodo di retention di base
specificato o una policy di retention e un trigger definito dall'applicazione che può impostare un periodo di retention più lungo
quando il trigger si attiva. Il periodo di retention inizia solo quando si attiva la condizione di attivazione.
Quando una C-Clip è contrassegnata per EBR, non può essere eliminata prima dell'evento a meno che non venga utilizzata un'eliminazione
con privilegi.

Quando si utilizza EBR, il ciclo di vita di C-Clip è il seguente:

• Create: l'applicazione crea una nuova C-Clip e la contrassegna come all'interno di EBR. L'applicazione
  può fornire un periodo di retention fisso che funge da retention minima e deve fornire un periodo o una
  policy di retention basata su eventi.
• Trigger Event: l'applicazione attiva l'evento, che è il punto di partenza del periodo di retention basata su
  eventi o della policy di retention. L'applicazione può assegnare un nuovo periodo di retention basata su
  eventi, se è più lungo di quello assegnato al momento della creazione della
  C-Clip.
• Delete: quando l'applicazione tenta di eliminare la C-Clip, devono essere soddisfatte le seguenti condizioni:
  Retention della policy (namespace) scaduta
  Retention del bucket scaduta
  Retention fissa scaduta
  L'evento è stato attivato
  Sia l'EBR impostato al momento della creazione che le eventuali modifiche successive (estensioni) al momento dell'evento sono scadute

La figura seguente mostra i tre possibili scenari per una C-Clip in EBR:

• C1 ha una retention fissa o minima che è già scaduta prima dell'attivazione dell'evento.
• C2 ha una retention fissa o minima che scadrà prima della scadenza dell'EBR.
• C3 ha una retention fissa o minima che scadrà dopo la scadenza dell'EBR.

 

Per i namespace non conformi, i comandi di eliminazione con privilegi possono sovrascrivere la retention fissa e variabile
per EBR.

Quando si applica la retention EBR, deve essere conforme alle impostazioni di limite min/max per il periodo di retention
variabile.

La tabella mostra le funzioni dell'API CAS per la retention basata su eventi

Funzione	Descrizione
FPClip_EnableEBRWithClass	Questa funzione imposta una C-Clip in modo che sia idonea a ricevere un evento futuro e consente di assegnare una classe di retention basata su eventi (EBR) alla C-Clip durante la creazione della C-Clip.
FPClip_EnableEBRWithPeriod	Questa funzione imposta una C-Clip in modo che sia idonea a ricevere un evento futuro e consente di assegnare una classe di retention basata su eventi (EBR) alla C-Clip durante la creazione della C-Clip.
FPClip_IsEBREnabled	Questa funzione restituisce un valore booleano per indicare se è abilitata o meno una C-Clip per la retention basata su eventi (EBR).
FPClip_GetEBRClassName	Questa funzione recupera il nome della policy di retention basata su eventi (EBR) assegnata alla C-Clip.
FPClip_GetEBREventTime	Questa funzione restituisce l'ora dell'evento impostata su una C-Clip quando è attivato l'evento di retention basata su eventi (EBR) per tale C-Clip.
FPClip_GetEBRPeriod	Questa funzione restituisce il valore (in secondi) del periodo di retention basata su eventi (EBR) associato a una C-Clip.
FPClip_TriggerEBREvent	Questa funzione attiva l'evento di una C-Clip per cui è stata abilitata la retention basata su eventi (EBR).
FPClip_TriggerEBREventWithClass	Questa funzione attiva l'evento di una C-Clip per cui è stata abilitata la retention basata su eventi (EBR) e assegna una nuova policy EBR alla C-Clip.
FPClip_TriggerEBREventWithPeriod	Questa funzione attiva l'evento di una C-Clip per cui è stata abilitata la retention basata su eventi (EBR) e assegna un nuovo periodo EBR alla C-Clip.

 

 

Controversia

La controversia consente alle applicazioni CAS di impedire temporaneamente l'eliminazione di una C-Clip. La controversia è
utile per i dati soggetti a un'indagine ufficiale, a una citazione in giudizio o a una richiesta di informazioni che potrebbero non essere
eliminati fino alla fine dell'indagine. Quando non è più necessario conservare i dati, la controversia
può essere rilasciata dall'applicazione e riprende il normale comportamento di retention. L'applicazione CAS
posiziona e rimuove una controversia a livello di C-Clip.

Nota: Anche un'eliminazione con privilegi non può eliminare una C-Clip in caso di controversia.

Una C-Clip può essere presente in diverse controversie. L'applicazione deve generare ID di controversia
univoci ed essere in grado di monitorare le controversie specifiche associate a una C-Clip. L'applicazione
non può eseguire query su una C-Clip per queste informazioni. Esiste solo una funzione che determina lo stato di controversia
della C-Clip. Se si verificano una o più controversie nella C-Clip, questa funzione
restituisce True, altrimenti è False.

Quando si utilizza la controversia, il ciclo di vita della C-Clip è il seguente:

• Create: l'applicazione crea una nuova C-Clip e fornisce un periodo di retention fissa e/o
  basata su eventi.
• Set litigation hold: un'applicazione sospende la C-Clip per controversia. Questa applicazione può essere diversa
  dall'applicazione di scrittura della C-Clip.
• Release litigation hold: un'applicazione rilascia la C-Clip. Questa applicazione può essere diversa
  dall'applicazione che imposta la controversia o che ha scritto la C-Clip.
• Delete: quando l'applicazione tenta di eliminare la C-Clip, è necessario soddisfare le seguenti condizioni:
  Non ci sono altre controversie in sospeso sulla C-Clip.
  La retention delle policy è scaduta.
  La retention dei bucket standard è scaduta. (La retention dei bucket standard è disponibile per tutti i tipi di object ECS, ma non è consigliata per CAS.)
  Il periodo di retention fissa è scaduto (funzionalità solo per CAS).
  La retention basata su eventi è scaduta (funzionalità solo per CAS).

La figura seguente mostra i tre possibili scenari per una C-Clip sottoposto a controversia:

• C1 ha una retention fissa che è già scaduta al momento della sospensione per controversia.
• C2 ha una retention fissa che scade durante la sospensione.
• C3 ha una retention fissa che scadrà dopo il rilascio della sospensione.

È possibile assegnare più controversie a una C-Clip. In questo caso, ogni
controversia richiede una chiamata API separata con un ID univoco per la controversia.

Nota: La dimensione massima dell'ID di controversia è di 64 caratteri. Il numero massimo di ID
di controversia per C-Clip è di 100. Queste limitazioni vengono applicate dall'API CAS.

La tabella mostra le funzioni dell'API CAS per la controversia
 

Funzione	Descrizione
FPClip_GetRetentionHold	Questa funzione determina lo stato di sospensione per controversia della C-Clip e restituisce true o false.
FPClip_SetRetentionHold	Questa funzione imposta o reimposta una sospensione della retention su una C-Clip. Per più controversie, fornire un ID di controversia univoco per ciascuna sospensione. Per più sospensioni, effettuare una chiamata per ID.

Gli argomenti correlati a CAS di seguito sono descritti in ECS Data Access Guide e saranno separati in diversi KB:

• ECS: Configurazione del supporto CAS in ECS (in inglese) - KB 538783
  • Configurazione del supporto CAS in ECS
  • Cold storage
• ECS: Conformità per CAS (in inglese) - 538784 KB
  • Conformità e protezione avanzata della piattaforma
  • Policy di retention e conformità
  • Agent di conformità
• ECS: Retention CAS in ECS (in inglese) - KB 538782
  • Retention CAS
  • Retention avanzata per le applicazioni CAS: retention basata su eventi, controversia e limite min/max
• ECS: Configurazione delle policy di retention del namespace per CAS (in inglese) - KB 538786
• ECS: Best practice per l'amministrazione di bucket e utenti CAS (in inglese) - KB 478327
  • Creare e configurare un bucket per un utente CAS
  • Configurare un utente di object CAS
• ECS: Configurazione di ACL del bucket per CAS (in inglese) - KB 538789
• ECS: API di gestione ECS che supportano gli utenti CAS (in inglese) - KB 538790
• ECS: Supporto per API SDK CAS (Content Addressable Storage) (in inglese) - KB 538791
• ECS: Codici errore SDK CAS (Centera) (in inglese) - KB 427034