ECS: CAS-retentie in ECS

CAS-retentie in ECS

Een CAS C-Clip kan een bewaarperiode hebben die de duur van de tijd bepaalt. Het bijbehorende object wordt bewaard in ECS storage voordat een applicatie het kan verwijderen.


Bewaarperioden

Bewaarperioden worden toegewezen in de C-Clip voor het object door de CAS-applicatie.

Als een financieel document bijvoorbeeld drie jaar na de aanmaakdatum moet worden bewaard, wordt een
bewaarperiode van drie jaar gespecificeerd in de C-Clip die aan het financiële document is gekoppeld. Het is
ook mogelijk om aan te geven dat het document voor onbepaalde tijd wordt bewaard.

Bewaarbeleid (bewaarklassen)

Opmerking: Het Centera-concept van bewaarklassen wordt toegewezen aan bewaarpolicy's in ECS. Deze
documentatie maakt gebruik van bewaarbeleid.

Met het bewaarbeleid kunnen bewaarscenario's worden vastgelegd en toegepast op C-clips. Verschillende soorten documenten kunnen bijvoorbeeld
verschillende bewaarperioden hebben. Mogelijk hebt u de
volgende bewaarperioden nodig:

• Financiële: 3 jaar
• Juridische: 5 jaar
• E-mail: 6 maanden

Wanneer een bewaarbeleid wordt toegepast op verschillende C-clips, door het beleid te wijzigen. De bewaarperiode
verandert voor alle objecten waarop het beleid van toepassing is.

Bewaarpolicy's zijn gekoppeld aan namespaces in ECS en worden door de CAS-applicatie
herkend als bewaarklassen.
 

ECS-retentie op bucketniveau en CAS

Retentie op bucketniveau is niet de standaard poolretentie in Centera. In ECS is
CAS-standaardretentie voortdurend nul.
 

Standaardretentieperiode in objecten die zijn geschreven zonder retentie op objectniveau in compliance-naamruimten
.

Vanaf ECS 3.0, wanneer een applicatie C-Clips schrijft zonder objectretentie naar een ECS CAS-bucket
in een compliance-namespace en de bucket een bewaarwaarde heeft (bijvoorbeeld 6 maanden),
wordt de standaard bewaarperiode van oneindige (-1) toegewezen aan de C-Clips. De C-Clips kunnen nooit
worden verwijderd omdat de effectieve bewaarperiode het langst is tussen de twee: de
bewaarperiode op bucketniveau en de standaard bewaarperiode op objectniveau.
 

CAS-prioriteit

Wanneer meerdere bewaarperioden worden toegepast op een CAS-object in ECS, heeft de bewaarperiode met de
hogere waarde voorrang, ongeacht hoe de retentie is toegepast.
 

CAS-retentie toepassen

U kunt bewaarpolipoliss definiëren voor namespaces in de ECS Portal of met de ECS Management
API. Zie Bewaarpolicy's voor naamruimte instellen.

Uw externe CAS-applicatie kan tijdens het maken een vaste bewaarperiode of een bewaarbeleid toewijzen aan de C-Clip
.

Geef de periode in seconden op wanneer u bewaarperioden toepast via API's.

Opmerking: ECS CAS neemt de aanmaaktijd van de C-Clip voor alle retentiegerelateerde berekeningen en
niet de migratietijd.

Bewaarpolicy's maken met de ECS Management API.

U kunt bewaarperioden en beleidsregels maken met behulp van de ECS, waarvan hieronder een samenvatting wordt gegeven
.

Methode	Beschrijving
PUT /object/bucket/{bucketName}/retentie	De bewaarwaarde voor een bucket definieert een verplichte bewaarperiode die wordt toegepast op elk object in een bucket. Als u een bewaarperiode van 1 jaar instelt, kan een object uit de bucket niet één jaar worden verwijderd.
GET /object/bucket/{bucketName}/retention	Retourneert de bewaarperiode die momenteel is ingesteld voor een opgegeven bucket.
POST /object/namespaces/namespace/{namespace}/ retention	Voor namespaces fungeert de bewaarinstelling als een beleid, waarbij elk beleid een <Name>:<Retention period-paar> is. U kunt verschillende bewaarpolicy's voor een namespace definiëren en u kunt een beleid, op naam, toewijzen aan een object binnen de naamruimte. Hiermee kunt u de bewaarperiode wijzigen van een set objecten waaraan hetzelfde beleid is toegewezen door het bijbehorende beleid te wijzigen.
PUT /object/namespaces/namespace/{namespace}/ retention/{class}	Werkt de periode bij voor een bewaarperiode die is gekoppeld aan een naamruimte.
GET /object/namespaces/namespace/{namespace}/ retention	Retourneert het bewaarbeleid dat is gedefinieerd voor een namespace.

Meer informatie over de ECS Management API vindt u in de inleiding tot ECS Management REST API
in de ECS Data Access Guide. De online referentie vindt u hier: ECS API-referentie.

Geavanceerde retentie voor CAS-applicaties: retentie op basis van gebeurtenissen, rechtszaken en de min/max.

Beschrijft geavanceerde bewaarfuncties die beschikbaar zijn in de CAS API die worden ondersteund door ECS.

Klantapplicaties gebruiken de CAS API om bewaarstrategieën mogelijk te maken. Wanneer CAS-workloads worden
gemigreerd naar ECS, stellen ECS-kennis van CAS API-functies de klantapplicaties in staat om te blijven
werken met de gemigreerde data. In ECS zijn de volgende geavanceerde retentiebeheerfuncties (ARM)
beschikbaar zonder een afzonderlijke licentie:

• Op gebeurtenis gebaseerde retentie: de mogelijkheid om een object te configureren via de C-Clip om een
  bewaarperiode of bewaarbeleid toe te passen (activeren) wanneer de CAS-applicatie een opgegeven gebeurtenis ontvangt.
• Juridische hold: de mogelijkheid om verwijdering van een object te voorkomen als de CAS-applicatie een
  rechtszaak heeft toegepast op het object via de C-Clip. De CAS-aanvraag kan tot 100
  rechtszaken toepassen op een object door unieke proces-ID's te maken en toe te passen.
• Min./max. aantal personen: De mogelijkheid voor een beheerder om bucketniveaulimieten in te stellen voor een vaste bewaarperiode
  of variabele bewaarperiode. Een variabele bewaarperiode is een periode die is ingesteld om op gebeurtenis gebaseerde retentie te ondersteunen
  . In ECS kunnen systeem- of namespacebeheerders de waarden instellen met de ECS
  Portal. Programmeurs kunnen de ECS Management API gebruiken om de waarden in te stellen.

Opmerking: ARM wordt ondersteund voor legacy CAS-data die worden geschreven met een naamgevingsschema dat is gemigreerd
naar ECS.

Min./max. retentie op CAS-bucketniveau

Zoek in de ECS Portal een CAS-bucket en selecteer Bewerken. Alle functies die op het onderstaande scherm
worden weergegeven, zijn alleen CAS-functies, behalve de functie Bucket Retention Period . Bucketretentie
De periode is de standaard ECS-bucketretentiefunctie die wordt ondersteund op alle ECS-buckettypen.

De CAS-bucketretentiefuncties worden uitgelegd in de volgende tabel.
 

Kenmerk	Beschrijving
Bewaren afdwingen	Als deze functie is ingeschakeld, kan er geen CAS-object worden gemaakt zonder bewaargegevens (periode of beleid). Een poging om een dergelijk object op te slaan retourneert een fout. Als deze is ingeschakeld, is het mogelijk om de bucketretentieperiode niet te configureren, zelfs niet in een omgeving die geschikt is voor naleving. Opmerking: Wanneer een CE+-modus Centera wordt gemigreerd naar ECS, is Enforce Retention standaard ingeschakeld op de bucket.
Bewaarperiode bucket	Als een bewaarperiode voor een bucket wordt opgegeven, wordt de langere periode afgedwongen als er zowel een retentieperiode op bucketniveau als een bewaarperiode op objectniveau is . In een omgeving met compliance is bucketretentieperiode verplicht tenzij bewaargegevens in het object worden afgedwongen. Nadat deze is geconfigureerd, kan de bucketretentieperiode echter niet worden gereset, zelfs niet wanneer de bewaargegevens in het object worden afgedwongen.
Minimale vaste bewaarperiode	Deze functie is van toepassing op de bewaarperioden die zijn opgegeven in objecten. Als de bewaarperiode van een object buiten de hier opgegeven grenzen ligt, mislukt een poging om het object te schrijven. Met behulp van bewaarpolicy's worden de min/max-instellingen niet afgedwongen. Het selecteren van Infinite voor minimale vaste bewaarperiode betekent dat alle bewaarwaarden oneindig moeten zijn. Als u if for Maximum Fixed Retention Period selecteert, betekent dit dat er geen maximumlimiet is. Min./max . bewaarbeperkingen worden toegepast op C-Clip die naar een bucket wordt geschreven. Als een clip wordt gemigreerd door een hulpprogramma van een externe SDK dat de retentie binnen de grenzen moet zijn, wordt er anders een fout gegenereerd.
Maximale vaste bewaarperiode
Minimale variabele bewaarperiode	Deze functie is van toepassing op variabele bewaarperioden die zijn opgegeven in objecten die gebruikmaken van gebeurtenisgebeurtenis. bewaren (EBR). In EBR wordt een basisretentieperiode ingesteld en heeft de geprogrammeerde triggerfunctie de mogelijkheid om de retentieperiode te verhogen wanneer de triggers gaan branden. Als de nieuwe bewaarperiode van een object buiten de hier opgegeven grenzen valt, mislukt een poging om het object te schrijven als reactie op de trigger. Wanneer u bewaarpolicy's gebruikt, worden de min/max-instellingen niet afgedwongen. Als u Infinite selecteert voor minimale variabele bewaarperiode , moeten alle bewaarwaarden oneindig zijn. Als u if for Maximum Variable Retention Period selecteert, betekent dit dat er geen maximumlimiet is. Min./max. bewaarbeperkingen worden toegepast op C-Clip die naar een bucket wordt geschreven. Als een clip wordt gemigreerd door een hulpprogramma van derden dat op SDK's is gebaseerd, moet de retentie binnen de grenzen vallen , anders wordt er een fout gegenereerd.
Maximale variabele bewaarperiode

Opmerking: Als de systeembeheerder of programmeur geen waarden heeft ingesteld voor de vaste en
variabele bewaarperioden, retourneert de ECS Management API-functie geen waarden voor
de min/max-instellingen. De Enforce Retention Information in C-Clip retourneert een standaardwaarde
van false.
 

Bewaren op basis van gebeurtenissen

Event-based retention (EBR) is een instructie die aangeeft dat een record niet kan worden verwijderd vóór een
gebeurtenis en tijdens een opgegeven periode na de gebeurtenis. In CAS is EBR een C-Clip met een opgegeven bewaarperiode
of bewaarbeleid en een door de applicatie gedefinieerde trigger die een langere
bewaarperiode kan instellen wanneer de trigger brandt. De bewaarperiode begint pas wanneer de triggers branden.
Wanneer een C-Clip is gemarkeerd voor EBR, kan deze niet worden verwijderd voorafgaand aan de gebeurtenis, tenzij een geprivilegieerde verwijdering
wordt gebruikt.

Bij gebruik van EBR is de C-Clip-levenscyclus als volgt:

• Create: de applicatie maakt een nieuwe C-Clip en markeert deze als onder EBR. De applicatie
  kan een vaste bewaarperiode bieden die fungeert als een minimale bewaarperiode en moet een
  op gebeurtenissen gebaseerde bewaarperiode of beleid verstrekken.
• Trigger-gebeurtenis: De applicatie activeert de gebeurtenis, het beginpunt van de bewaarperiode of het bewaarbeleid op basis
  van gebeurtenissen. De applicatie kan een nieuwe bewaarperiode op basis van
  gebeurtenissen toewijzen als deze langer is dan de periode die is toegewezen op het moment van het maken van de CClip
  .
• Verwijderen: Wanneer de applicatie de C-Clip probeert te verwijderen, moet aan de volgende voorwaarden worden voldaan:
  Policy (namespace) retention has expired Bucket retention has expired Fixed retention has expired The event has been triggered Both the EBR set at the creation and any subsequent changes (extensions) at the event have expired (Policy (namespace) retention has expired
  
  Fixed retention has expired
  The event has been triggered
  Both the EBR set at the creation and any subsequent changes (extensions) at the time of the event have expired

De volgende afbeelding toont de drie mogelijke scenario's voor een C-Clip onder EBR:

• C1 heeft een vaste of minimale retentie die al is verlopen voordat de gebeurtenis werd geactiveerd.
• C2 heeft een vaste of minimale retentie die verloopt voordat de EBR verloopt.
• C3 heeft een vaste of minimale retentie die verloopt nadat de EBR is verlopen.

 

Voor niet-compatibele namespaces kunnen met bevoegdheden verwijderde opdrachten vaste en variabele
retentie voor EBR overschrijven.

Bij het toepassen van EBR-retentie moet deze voldoen aan de Min/Max-instellingen voor de variabele
bewaarperiode.

De tabel toont de CAS API-functies voor op gebeurtenissen gebaseerde retentie

Functie	Beschrijving
FPClip_EnableEBRWithClass	Deze functie stelt in dat een C-Clip in aanmerking komt voor het ontvangen van een toekomstige gebeurtenis en zorgt ervoor dat een op gebeurtenis gebaseerde retentieklasse (EBR) aan de CClip kan worden toegewezen tijdens het maken van de C-Clip.
FPClip_EnableEBRWithPeriod	Met deze functie stelt u in dat een C-Clip in aanmerking komt voor het ontvangen van een toekomstige gebeurtenis en kan een EBR-periode (Event Based Retention) aan de C-Clip worden toegewezen tijdens het maken van de C-Clip.
FPClip_IsEBREnabled	Deze functie retourneert een Booleaanse waarde om aan te geven of een CClip is ingeschakeld voor op gebeurtenissen gebaseerde retentie (EBR).
FPClip_GetEBRClassName	Deze functie haalt de naam op van de op gebeurtenissen gebaseerde retentie (EBR). policy toegewezen aan de C-Clip.
FPClip_GetEBREventTime	Deze functie retourneert de gebeurtenistijd die is ingesteld op een C-Clip wanneer de gebeurtenis event based retention (EBR) voor die C-Clip werd geactiveerd.
FPClip_GetEBRPeriod	Deze functie retourneert de waarde (in seconden) van de EBR-periode (event-based retention) die is gekoppeld aan een C-Clip.
FPClip_TriggerEBREvent	Deze functie activeert de gebeurtenis van een C-Clip waarvoor event based retention (EBR) is ingeschakeld.
FPClip_TriggerEBREventWithClass	Deze functie activeert de gebeurtenis van een C-Clip waarvoor event based retention (EBR) is ingeschakeld en wijst een nieuw EBR-beleid toe aan de CClip.
FPClip_TriggerEBREventWithPeriod	Deze functie activeert de gebeurtenis van een C-Clip waarvoor event based retention (EBR) is ingeschakeld en wijst een nieuwe EBR-periode toe aan de CClip.

 

 

Rechtszaak in behandeling

Met Een rechtszaak stand kunnen CAS-applicaties tijdelijk verwijdering van een C-Clip voorkomen. Een juridische procedure is
nuttig voor gegevens die onderhevig zijn aan een officieel onderzoek, een dagvaarding of een onderzoek en die pas kunnen worden
verwijderd als het onderzoek is afgelopen. Zodra het niet nodig is om de data vast te houden, kan de rechtszaak
worden vrijgegeven door de applicatie en wordt het normale bewaargedrag hervat. De CAS-applicatie
plaatst en verwijdert een rechtszaak op C-Clip-niveau.

Opmerking: Zelfs een geprivilegieerde verwijdering kan een C-Clip onder rechtszaken niet verwijderen.

Eén C-Clip kan in verschillende rechtszaken vallen. De aanvraag moet unieke proces-ID's
genereren en de specifieke rechtszaken met betrekking tot een C-Clip kunnen volgen. De applicatie
kan geen query uitvoeren op een C-Clip voor deze informatie. Er is alleen een functie die bepaalt of de processtatus
van de C-Clip geldig is. Als er een of meerdere rechtszaken gaande zijn op de C-Clip, wordt deze functie
waar weergegeven, anders is het onjuist.

Bij het gebruik van een rechtszaak is de C-Clip-levenscyclus als volgt:

• Maken: De applicatie maakt een nieuwe C-Clip en biedt een vaste en/of op gebeurtenis gebaseerde
  bewaarperiode.
• Instellen van rechtszaken in stand houden: Een applicatie zet de C-Clip in de wacht. Deze applicatie kan afwijken
  van de applicatie die de C-Clip heeft geschreven.
• Vrijgave van rechtszaken: Een applicatie publiceert de C-Clip. Deze applicatie kan afwijken
  van de applicatie die de rechtszaak in stand houdt of de C-Clip heeft geschreven.
• Verwijderen: Wanneer de applicatie de C-Clip probeert te verwijderen, moet aan de volgende voorwaarden worden voldaan:
  Er zijn geen andere procedures in de C-Clip.
  Policyretentie is verlopen.
  Standaard bucketretentie is verlopen. (Standaard bucketretentie is beschikbaar voor alle ECS objecttypen, maar wordt niet aanbevolen voor CAS.)
  Vaste bewaarperiode is verlopen (cas-only-functie).
  Retentie op basis van gebeurtenissen is verlopen (cas-only-functie).

De volgende afbeelding toont de drie mogelijke scenario's voor een C-Clip die in behandeling wordt gesteld bij een rechtszaak:

• C1 heeft een vaste retentie die al is verlopen wanneer deze in de wacht wordt gezet.
• C2 heeft een vaste retentie die tijdens de wachtperiode verloopt.
• C3 heeft een vaste retentie die verloopt na het losmaken van de wachtstand.

Aan een C-Clip kunnen meerdere rechtszaken worden toegewezen. Als dit het geval is, vereist elke rechtszaak een
afzonderlijke API-oproep met een unieke identificatiecode voor de procesafsing.

Opmerking: De maximale grootte van de blokkerings-ID voor rechtszaken is 64 tekens. De maximale proces-ID's
per C-Clip is 100. Deze beperkingen worden afgedwongen door de CAS API.

De tabel toont de CAS API-functies voor rechtszaken
 

Functie	Beschrijving
FPClip_GetRetentionHold	Deze functie bepaalt de wachtstatus van de C-Clip en retourneert true of false.
FPClip_SetRetentionHold	Met deze functie wordt een retentieblokkering ingesteld of gereset op een C-Clip. Voor meerdere rechtszaken geldt dat u voor elke hold een unieke id voor proces-holds aangeeft. Voor meerdere wachtverzoeken voert u één oproep per ID uit.

De onderstaande CAS-gerelateerde onderwerpen worden beschreven in de ECS Data Access Guide en worden gescheiden in verschillende KB's:

• ECS: CAS-support instellen in ECS - KB-538783
  • CAS-support instellen in ECS
  • Koude opslag
• ECS: Naleving voor CAS - KB-538784
  • Platformverharding en naleving
  • Nalevings- en bewaarbeleid
  • Compliance-agent
• ECS: CAS-retentie in ECS - KB-538782
  • CAS-retentie
  • Geavanceerde retentie voor CAS-applicaties: retentie op basis van gebeurtenissen, rechtszaken en de min/max.
• ECS: Bewaarpolicy's voor naamruimte instellen voor CAS - KB-538786
• ECS: Aanbevolen werkwijzen voor CAS-gebruikers- en bucketbeheer - KB-478327
  • Een bucket voor een CAS-gebruiker maken en instellen
  • Een CAS-objectgebruiker instellen
• ECS: Bucket-ACL's instellen voor CAS - KB-538789
• ECS: ECS Management API's die CAS-gebruikers ondersteunen - KB 538790
• ECS: Ondersteuning voor CONTENT Addressable Storage (CAS) SDK API - KB-538791
• ECS: CAS (Centera) SDK-foutcodes - KB-427034