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:
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.
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:
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:
La figura seguente mostra i tre possibili scenari per una C-Clip in 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:
La figura seguente mostra i tre possibili scenari per una C-Clip sottoposto a controversia:
È 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: