ECS: CAS-kvarhållande i ECS

CAS-kvarhållande i ECS

En CAS C-klämma kan ha en kvarhållandeperiod som styr tidsperiodens längd. Det associerade objektet behålls i ECS-lagringen innan ett program kan ta bort det.


Kvarhållandeperioder

Kvarhållningsperioder tilldelas i C-Clip för objektet av CAS-programmet.

Om till exempel ett ekonomiskt dokument måste behållas i tre år från det att det skapades anges en
kvarhållandeperiod på tre år i C-klippet som är kopplat till finansieringsdokumentet. Det är
också möjligt att ange att dokumentet behålls på obestämd tid.

Kvarhållningspolicyer (kvarhållningsklasser)

Obs! Centera-konceptet med kvarhållningsklasser mappar till lagringspolicyer i ECS. I den här
dokumentationen används lagringspolicyer.

Lagringspolicyer gör att lagringsanvändningsfall kan registreras och tillämpas på C-klipp. Olika typer av dokument kan till exempel
ha olika kvarhållandeperioder. Du kan behöva
följande kvarhållandeperioder:

• Finansiella: 3 år
• Rättsliga: 5 år
• Mejl: 6 månader

När en lagringspolicy tillämpas på flera C-klipp genom att ändra policyn. Kvarhållandeperioden
ändras för alla objekt som policyn gäller för.

Lagringspolicyer är associerade med namnrymder i ECS och identifieras av CAS-programmet
som kvarhållandeklasser.
 

ECS-bucketnivålagring och CAS

Lagring på bucketnivå är inte standardlagring av pool i Centera. I ECS är
CAS standardlagring konstant noll.
 

Standardlagringsperiod för objekt skrivna utan kvarhållande på objektnivå i namnrymder för överensstämmelse
.

Från och med ECS 3.0 tilldelas standardlagringsperioden för oändligt (-1) till C-clips när ett program skriver C-clips utan objektlagring till en ECS CAS-bucket
i en kompatibilitetsnamnrymd och bucketen har ett kvarhållandevärde (till exempel
sex månader). C-klämmorna kan aldrig
tas bort eftersom den effektiva kvarhållningsperioden är den längsta mellan de två:
kvarhållandeperioden på bucketnivå och standardlagring på objektnivå.
 

CAS-prioritet

När flera kvarhållandeperioder tillämpas på ett CAS-objekt i ECS har kvarhållningsperioden med det
högre värdet företräde oavsett hur kvarhållandet tillämpades.
 

Så här tillämpar du CAS-kvarhållande

Du kan definiera kvarhållandet av namnrymder i ECS-portalen eller med ECS Management
API. Se Set up namespace retention policies.

Det externa CAS-programmet kan tilldela en fast kvarhållningsperiod eller en lagringspolicy till C-klippet
när det skapas.

När du tillämpar kvarhållandeperioder via API:er anger du perioden i sekunder.

Obs! ECS CAS tar tiden att skapa C-klippet för alla lagringsrelaterade beräkningar och
inte migreringstiden.

Skapa kvarhållningspolicyer med ECS Management API.

Du kan skapa kvarhållningsperioder och -principer med hjälp av ECS, en sammanfattning som visas
nedan.

Metod	Beskrivning
PUT /object/bucket/{bucketName}/retention	Lagringsvärdet för en bucket definierar en obligatorisk kvarhållningsperiod som tillämpas på varje objekt i en bucket. Om du anger en kvarhållandeperiod på 1 år kan ett objekt från bucketen inte tas bort för ett år.
GET /object/bucket/{bucketName}/retention	Returnerar kvarhållningsperioden som är inställd för en angiven bucket.
POST /object/namespaces/namespace/{namespace}/ retention	För namnrymder fungerar kvarhållningsinställningen som en policy, där varje policy är ett <par för namn>:<kvarhållandeperiod> . Du kan definiera flera lagringsprinciper för en namnrymd och du kan tilldela en policy, efter namn, till ett objekt inom namnrymden. På så sätt kan du ändra kvarhållningsperioden för en uppsättning objekt som har samma policy tilldelad genom att ändra motsvarande policy.
PUT /object/namespaces/namespace/{namespace}/ retention/{class}	Uppdaterar perioden för en kvarhållandeperiod som är kopplad till en namnrymd.
GET /object/namespaces/namespace/{namespace}/ retention	Returnerar lagringspolicyn som definierats för en namnrymd.

Mer information om ECS Management API finns i introduktionen till ECS Management REST API
på ECS Data Access Guide. Onlinereferensen finns här: ECS API-referens.

Avancerad kvarhållande för CAS-program: händelsebaserad kvarhållande, rättsprocessförvaring och minimi-/maxgränsen

Beskriver avancerade kvarhållandefunktioner som är tillgängliga i CAS API som stöds av ECS.

Kundprogram använder CAS API för att aktivera kvarhållningsstrategier. När CAS-arbetsbelastningar
migreras till ECS gör ECS-medvetenhet om CAS API-funktioner att kundprogrammen kan fortsätta
att arbeta med migrerade data. I ECS är följande avancerade funktioner för kvarhållningshantering (ARM)
tillgängliga utan separat licens:

• Händelsebaserad kvarhållning: möjligheten att konfigurera ett objekt via ett C-klipp för att tillämpa (utlösa) en
  kvarhållningsperiod eller kvarhållningspolicy när CAS-programmet tar emot en angiven händelse.
• Rättsprocessförseningar: möjligheten att förhindra borttagning av ett objekt om CAS-programmet har tillämpat en
  rättsprocess i objektet via C-klippet. CAS-programmet kan tillämpa upp till 100
  rättsprocessen på ett objekt genom att skapa och tillämpa unika sökvägs-ID.s.
• Min/Max. (min/max: En administratör kan ställa in bucket-nivågränser för fast kvarhållningsperiod
  eller variabel kvarhållandeperiod. En variabel kvarhållandeperiod är en period som är inställd på att stödja
  händelsebaserad lagring. I ECS kan system- eller namnrymdsadministratörer ställa in värdena med ECS-portalen
  . Programmerare kan använda ECS Management API för att ställa in värdena.

Obs! ARM stöds för äldre CAS-data skrivna med alla namngivningsscheman som migreras
till ECS.

Min/max för kvarhållande på CAS-bucketnivå

Från ECS-portalen letar du upp en CAS-bucket och väljer Edit. Alla funktioner som visas på skärmen
nedan är endast CAS-funktioner förutom funktionen Bucket Retention Period . Kvarhållande av
bucketPeriod är den standardfunktion för ECS-bucketlagring som stöds för alla ECS-buckettyper.

Cas-bucketlagringsfunktionerna förklaras i följande tabell.
 

Funktion	Beskrivning
Verkställ kvarhållande	Om den här funktionen är aktiverad kan inget CAS-objekt skapas utan kvarhållningsinformation (period eller policy). Ett försök att spara ett sådant objekt returnerar ett fel. Om den är påslagen är det möjligt att inte konfigurera bucketlagringsperiod ens i en miljö med överensstämmelseaktiverad . Obs! När ett CE+-läge Centera migreras till ECS är Enforce Retention aktiverat som standard i bucketen.
Bucketlagringsperiod	Om en bucketlagringsperiod anges tillämpas den längre perioden om det finns både en bucketnivå och en kvarhållandeperiod på objektnivå. I en kompatibilitetsaktiverad miljö är bucketlagringsperiod obligatorisk om inte kvarhållningsinformation i objektet verkställs. När lagringsperioden för bucketen har konfigurerats kan den inte återställas även när kvarhållningsinformation i objektet upprätthålls.
Minsta fasta kvarhållandeperiod	Den här funktionen styr lagringsperioder som anges i objekt. Om kvarhållandeperioden för ett objekt ligger utanför de gränser som anges här misslyckas ett försök att skriva objektet. Med hjälp av kvarhållningsprinciper tillämpas inte min/max-inställningarna. Om du väljer Infinite for Minimum Fixed Retention Period (oändligt för minsta fasta kvarhållandeperiod ) måste alla kvarhållandevärden vara oändliga. Om du väljer om den maximala fasta kvarhållningsperioden ska användas finns det ingen maximal gräns. Min/max retention constrains tillämpas på alla C-klipp som skrivs på en bucket. Om ett klipp migreras av något SDK-baserat verktyg från tredje part ska kvarhållandet vara inom gränser, annars utlöses ett fel.
Maximal fast kvarhållandeperiod
Minsta variabel kvarhållandeperiod	Den här funktionen styr variabla kvarhållningsperioder som anges i objekt med händelsebaserad. kvarhållande (EBR). I EBR ställs en basretentionsperiod in och den programmerade utlösarfunktionen har förmågan att öka kvarhållandeperioden när utlösarfunktionen aktiverar. Om ett objekts nya kvarhållandeperiod ligger utanför de gränser som anges här misslyckas ett försök att skriva objektet som svar på utlösaren. När du använder kvarhållningsprinciper tillämpas inte min/max-inställningarna. Om du väljer Infinite for Minimum Variable Retention Period måste alla kvarhållandevärden vara oändliga. Om du väljer om den maximala variabla kvarhållningsperioden ska användas finns det ingen maximal gräns. Min/max retention constrains tillämpas på alla C-klipp som skrivs på en bucket. Om ett klipp migreras av något SDK-baserat verktyg från tredje part ska kvarhållandet vara inom gränser, annars utlöses ett fel.
Maximal variabel kvarhållandeperiod

Obs! Om systemadministratören eller programmeraren inte har angett några värden för de fasta och
variabla kvarhållandeperioderna returnerar inte ECS Management API-hämtar-funktionen värden för
min/max-inställningarna. Genom att aktivera kvarhållningsinformation i C-klippet returneras standardvärdet
false.
 

Händelsebaserad lagring

Händelsebaserad kvarhållande (EBR) är en instruktion som anger att en post inte kan tas bort före en
händelse och under en angiven period efter händelsen. I CAS är EBR ett C-klipp med en angiven baslagringsperiod
eller lagringspolicy och en programdefinierad utlösare som kan ställa in en längre
kvarhållningsperiod när utlösarfördelen aktiveras. Kvarhållandeperioden börjar endast när utlösareffekten aktiveras.
När ett C-klipp är markerat för EBR kan det inte tas bort före händelsen om inte en privilegierad borttagning
används.

När du använder EBR är C-Clip-livscykeln följande:

• Skapa: programmet skapar ett nytt C-klipp och markerar det som under EBR. Programmet
  kan tillhandahålla en fast kvarhållandeperiod som fungerar som ett minsta kvarhållande och den måste tillhandahålla en
  händelsebaserad kvarhållandeperiod eller policy.
• Utlösarhändelse: Programmet utlöser händelsen, som är startpunkten för den händelsebaserade
  kvarhållningsperioden eller kvarhållningspolicyn. Programmet kan tilldela en ny händelsebaserad
  kvarhållningsperiod om den är längre än den som tilldelades vid tiden för CClip-skapandet
  .
• Ta bort: När programmet försöker ta bort C-klippet måste följande villkor uppfyllas:
  Policylagring (namnrymd) har upphört
  att gälla Bucket-kvarhållandet har upphört
  att gälla. Åtgärdat
  kvarhållande har utlösts
  Både EBR-uppsättningen vid tidpunkten för skapandet och eventuella efterföljande ändringar (tillägg) vid tidpunkten för händelsen har förfallit

Följande bild visar de tre möjliga scenarierna för ett C-Klipp under EBR:

• C1 har ett fast eller minimalt kvarhållande som redan gick ut innan händelsen utlöstes.
• C2 har ett fast eller minimalt kvarhållande som löper ut innan EBR löper ut.
• C3 har ett fast eller minimalt kvarhållande som löper ut efter att EBR löper ut.

 

För icke-kompatibla namnrymder kan privilegierade borttagningskommandon åsidosätta korrigerad och variabel
kvarhållande för EBR.

När EBR-kvarhållandet tillämpas måste det följa inställningarna för Min/Max Avig för den variabla
kvarhållandeperioden.

Tabellen visar CAS API-funktionerna för händelsebaserad lagring

Funktion	Beskrivning
FPClip_EnableEBRWithClass	Den här funktionen ställer in ett C-klipp så att det är berättigat att ta emot en framtida händelse och gör det möjligt att tilldela en händelsebaserad kvarhållningsklass (EBR) till CClip under skapande av C-klipp.
FPClip_EnableEBRWithPeriod	Den här funktionen ställer in ett C-klipp så att det är berättigat att ta emot en framtida händelse och gör det möjligt att tilldela en händelsebaserad kvarhållningsperiod (EBR) till C-klippet under skapande av C-klipp.
FPClip_IsEBREnabled	Den här funktionen returnerar ett booleskt värde för att ange om ett CClip är aktiverat för händelsebaserad kvarhållning (EBR).
FPClip_GetEBRClassName	Den här funktionen hämtar namnet på den händelsebaserade kvarhållningen (EBR). policy som tilldelats C-klippet.
FPClip_GetEBREventTime	Den här funktionen returnerar den händelsetid som ställts in på ett C-klipp när den händelsebaserade kvarhållningshändelsen (EBR) för det C-klippet utlöstes.
FPClip_GetEBRPeriod	Den här funktionen returnerar värdet (i sekunder) för den händelsebaserade kvarhållningsperioden (EBR) som är kopplad till ett C-klipp.
FPClip_TriggerEBREvent	Den här funktionen utlöser händelsen av ett C-klipp för vilket händelsebaserad kvarhållning (EBR) aktiverades.
FPClip_TriggerEBREventWithClass	Den här funktionen utlöser händelsen av ett C-klipp för vilket händelsebaserad kvarhållning (EBR) har aktiverats och tilldelar en ny EBR-princip till CClip.
FPClip_TriggerEBREventWithPeriod	Den här funktionen utlöser händelsen av ett C-klipp för vilket händelsebaserad kvarhållning (EBR) har aktiverats och tilldelar en ny EBR-period till CClip.

 

 

Kvarhållen rättsprocess

Rättsprocessförseningar gör det möjligt för CAS-program att tillfälligt förhindra borttagning av ett C-klipp. Kvarhållna rättsprocesser är
användbara för data som är föremål för en officiell utredning, anmälan eller förfrågan och som kanske inte tas
bort förrän undersökningarna är över. När det inte finns något behov av att behålla data kan rättsprocessen
frisläppas av programmet och normalt kvarhållandebeteende återupptas. CAS-programmet
placerar och tar bort en rättsprocess på C-Clip-nivån.

Obs! Inte ens en privilegierad borttagning kan ta bort ett C-klipp under rättsprocessen.

Ett C-klipp kan vara under flera rättsprocessens kvarhållanden. Programmet måste generera unika rättsprocessens
hold-ID:er och kunna spåra de specifika rättsprocessen som är kopplade till ett C-klipp.
Programmet kan inte fråga efter ett C-klipp för den här informationen. Det finns bara en funktion som avgör rättsprocessens
kvarhållningsstatus för C-klippet. Om det finns en eller flera rättsprocessen för C-klippet återgår den här funktionen
till true, annars är den falsk.

När du använder rättsprocesssspärr är C-Clip-livscykeln följande:

• Skapa: Programmet skapar ett nytt C-klipp och tillhandahåller en fast och/eller händelsebaserad
  kvarhållandeperiod.
• Ställ in rättsprocessspärr: Ett program håller C-klippet på plats. Det här programmet kan skilja
  sig från det program som skrev C-klippet.
• Frigöringsspärr: Ett program släpper C-klippet. Det här programmet kan skilja
  sig från det program som ställer in rättsprocessen eller skrev C-klippet.
• Ta bort: När programmet försöker ta bort C-klippet måste följande villkor vara uppfyllda:
  Det finns inga andra rättsprocessen för C-Klippet.
  Policylagring har upphört att gälla.
  Standardlagring av bucket har upphört att gälla. (Standardlagring av bucket är tillgängligt för alla ECS-objekttyper, men rekommenderas inte för CAS.)
  Den fasta kvarhållningsperioden har löpt ut (endast CAS-funktion).
  Händelsebaserad kvarhållning har upphört att gälla (endast CAS-funktion).

Följande bild visar de tre möjliga scenarierna för ett C-Klipp som satts under rättsprocess:

• C1 har ett fast kvarhållande som redan har upphört att gälla när det satts i kvarhållande.
• C2 har ett fast kvarhållande som löper ut under kvarhållandet.
• C3 har ett fast kvarhållande som löper ut efter att kvarhållandet har släppts.

Ett C-klipp kan ha flera rättsprocessens kvarhållanden tilldelade till det. Om så är fallet kräver varje rättsprocess
ett separat API-anrop med en unik identifierare för rättsprocessen.

Obs! Den maximala storleken på rättsprocesss-ID är 64 tecken. Den maximala rättsprocessens kvarhållna ID:
er per C-Klipp är 100. Dessa begränsningar tillämpas av CAS API.

Tabellen visar CAS API-funktionerna för rättsprocess
 

Funktion	Beskrivning
FPClip_GetRetentionHold	Den här funktionen avgör C-klippets kvarhållna status och returnerar sant eller falskt.
FPClip_SetRetentionHold	Den här funktionen ställer in eller återställer ett kvarhållande på ett C-klipp. För flera rättsprocessshållanden ska du tillhandahålla ett unikt rättsprocess-ID för varje kvarhållande. För flera kvarhållanden ska du ringa ett samtal per ID.

De CAS-relaterade ämnena nedan beskrivs i manualen för ECS-dataåtkomst och kommer att delas in i olika KB:s:

• ECS: Konfigurera CAS-stöd i ECS – KB 538783
  • Konfigurera CAS-stöd i ECS
  • Kallförvaring
• ECS: Överensstämmelse för CAS – kb-538784
  • Plattformshärdning och överensstämmelse
  • Efterlevnads- och lagringspolicy
  • Regelefterlevnadsagent
• ECS: CAS-kvarhållande i ECS – KB-538782
  • CAS-kvarhållande
  • Avancerad kvarhållande för CAS-program: händelsebaserad kvarhållande, rättsprocessförvaring och minimi-/maxgränsen
• ECS: Konfigurera namnrymdlagringsprinciper för CAS – KB-538786
• ECS: Bästa praxis för administration av CAS-användare och bucketar – KB 478327
  • Skapa och konfigurera en bucket för en CAS-användare
  • Konfigurera en CAS-objektanvändare
• ECS: Konfigurera bucket-ACL för CAS – KB 538789
• ECS: API:er för ECS-hantering som har stöd för CAS-användare – KB 538790
• ECS: Stöd för SDK API för innehållsadresserbar lagring (CAS) – KB 538791
• ECS: CAS(Centera) SDK-felkoder – KB 427034