ECS: CAS-opbevaring i ECS
Summary: Denne artikel handler om CAS-opbevaring i ECS. Den beskriver også avanceret opbevaring for CAS-programmer: hændelsesbaseret opbevaring, retslig tilbageholdelse og min./maks. guvernør
Instructions
Det er et uddrag af ECS Data Access Guide, hvad der kan findes og downloades her: Produktside for ECS-enhed
CAS-opbevaring i ECS
Et CAS C-klip kan have en opbevaringsperiode, der styrer længden af tiden. Det tilknyttede objekt bevares i ECS-lageret, før et program kan slette det.
Opbevaringsperioder
Opbevaringsperioder tildeles objektet i C-clipsen af CAS-programmet.
Hvis et finansdokument f.eks. skal opbevares i tre år fra oprettelsesdatoen, angives der en
treårig opbevaringsperiode i den C-Clip, der er knyttet til finansdokumentet. Det er
også muligt at angive, at dokumentet opbevares på ubestemt tid.
Opbevaringspolitikker (opbevaringsklasser)
Bemærk: Centera-konceptet med opbevaringsklasser knyttes til opbevaringspolitikker i ECS, denne
dokumentation bruger opbevaringspolitikker.
Opbevaringspolitikker gør det muligt at registrere og anvende brugsscenarier for opbevaring på C-Clips. Forskellige typer dokumenter kan f.eks
. have forskellige opbevaringsperioder. Du kan kræve følgende
opbevaringsperioder:
- Finansiel: 3 år
- Juridisk: 5 år
- E-mail: 6 måneder
Når en opbevaringspolitik anvendes på flere C-Clips, ved at ændre politikken. Opbevaringsperioden
ændres for alle objekter, som politikken gælder for.
Opbevaringspolitikker er knyttet til navneområder i ECS og genkendes af CAS-programmet
som opbevaringsklasser.
Opbevaring på ECS-bucketniveau og CAS
Opbevaring på bucket-niveau er ikke standardpuljeopbevaring i Centera. I ECS er
CAS-standardopbevaring konstant nul.
Standardopbevaringsperiode for objekter, der er skrevet uden opbevaring på objektniveau i
overholdelsesnavneområder.
Fra og med ECS 3.0 tildeles C-Clips standardopbevaringsperioden på uendelig (-1) til C-clipsene, når et program skriver C-clips uden objektopbevaring til en ECS CAS-bucket
i et overholdelsesnavneområde, og bucket har en opbevaringsværdi (f.eks. 6 måneder).
C-clips kan aldrig
slettes, fordi deres effektive opbevaringsperiode er den længste mellem de to: opbevaringsperioden på
bucketniveau og standardopbevaringsperioden på objektniveau.
CAS-forrang
Når der anvendes flere opbevaringsperioder på et CAS-objekt i ECS, har opbevaringsperioden med den
højeste værdi forrang, uanset hvordan opbevaringen blev anvendt.
Sådan anvendes CAS-opbevaring
Du kan definere opbevaringspolitikker for navneområder på ECS-portalen eller med ECS Management
API. Se Konfigurere politikker for opbevaring af navneområde.
Dit eksterne CAS-program kan tildele en fast opbevaringsperiode eller en opbevaringspolitik til C-Clip'en
under oprettelsen.
Når du anvender opbevaringsperioder via API'er, skal du angive perioden i sekunder.
Bemærk: ECS CAS tager oprettelsestiden for C-Clip for alle opbevaringsrelaterede beregninger og
ikke migreringstiden.
Sådan opretter du opbevaringspolitikker med ECS Management API.
Du kan oprette opbevaringsperioder og politikker ved hjælp af ECS, som du får
en oversigt over nedenfor.
| Metode | Beskrivelse |
|---|---|
| PUT /objekt/bucket/{bucketName}/fastholdelse | Opbevaringsværdien for en bucket definerer en obligatorisk opbevaringsperiode, som anvendes på alle objekter i en bucket. Hvis du angiver en opbevaringsperiode på 1 år, kan et objekt fra bucket ikke slettes i et år. |
| GET /object/bucket/{bucketName}/retention | Returnerer den opbevaringsperiode, der aktuelt er angivet for en angivet bucket. |
| POST /objekt/navneområder/navneområde/{navneområde}/ opbevaring |
For navneområder fungerer opbevaringsindstillingen som en politik, hvor hver politik er et <par af typen Navn>:<Opbevaringsperiode> . Du kan definere flere opbevaringspolitikker for et navneområde, og du kan tildele en politik efter navn til et objekt i navneområdet. Dette giver dig mulighed for at ændre opbevaringsperioden for et sæt objekter, der har den samme politik tildelt ved at ændre den tilsvarende politik. |
| PUT /objekt/navneområder/navneområde/{navneområde}/ opbevaring/{klasse} |
Opdaterer perioden for en opbevaringsperiode, der er knyttet til et navneområde. |
| GET /objekt/navneområder/navneområde/{navneområde}/ opbevaring |
Returnerer den opbevaringspolitik, der er defineret for et navneområde. |
Du kan finde flere oplysninger om ECS Management API i ECS Management REST API-introduktion
på ECS Data Access Guide.
Avanceret opbevaring for CAS-programmer: hændelsesbaseret opbevaring, retslig tilbageholdelse og min./maks. regulator
Beskriver avancerede opbevaringsfunktioner, der er tilgængelige i CAS API, og som understøttes af ECS.
Kundeprogrammer bruger CAS API til at aktivere opbevaringsstrategier. Når CAS-workloads migreres
til ECS, gør ECS-kendskab til CAS API-funktioner det muligt for kundeprogrammer at fortsætte
med at arbejde med de migrerede data. I ECS er følgende avancerede fastholdelsesstyringsfunktioner (ARM)
tilgængelige uden en separat licens:
- Hændelsesbaseret opbevaring: muligheden for at konfigurere et objekt via dets C-Clip til at anvende (udløse) en
opbevaringsperiode eller opbevaringspolitik, når CAS-applikationen modtager en bestemt hændelse. - Retslig tilbageholdelse: evnen til at forhindre sletning af et objekt, hvis CAS-applikationen har anvendt en retslig tilbageholdelse på objektet
gennem dets C-Clip. CAS-programmet kan anvende op til 100
retslig tilbageholdelse af retssager på et objekt ved at oprette og anvende entydige retslig tilbageholdelses-id'er. - Min/Max guvernør: Muligheden for, at en administrator kan angive grænser på bucket-niveau for en fast opbevaringsperiode
eller variabel opbevaringsperiode. En variabel opbevaringsperiode er en, der er indstillet til at understøtte
hændelsesbaseret opbevaring. I ECS kan system- eller navneområdeadministratorer indstille værdierne med ECS-portalen
. Programmører kan bruge ECS Management API til at indstille værdierne.
Bemærk: ARM understøttes for ældre CAS-data, der er skrevet med ethvert navngivningsskema, der er migreret
til ECS.
Min./maks. regulator til opbevaring på CAS-skovlniveau
Find en CAS-bucket på ECS-portalen, og vælg Rediger. Alle de funktioner, der vises på skærmen
nedenfor, er kun CAS-funktioner med undtagelse af funktionen Bucket Retention Period . Opbevaring af
skovlPeriode er standardfunktionen til opbevaring af ECS-bucket, der understøttes på alle ECS-buckettyper.
CAS-skovlopbevaringsfunktionerne er forklaret i følgende tabel.
| Funktion | Beskrivelse |
|---|---|
| Gennemtving opbevaring | Hvis denne funktion er aktiveret, kan der ikke oprettes noget CAS-objekt uden opbevaringsoplysninger (periode eller politik). Et forsøg på at gemme et sådant objekt returnerer en fejl. Hvis den er aktiveret, er det muligt ikke at konfigurere Bucket Retention Period , selv i et overholdelsesaktiveret miljø. Bemærk: Når en Centera i CE+-tilstand migreres til ECS, er Gennemtving opbevaring aktiveret som standard på bucket. |
| Opbevaringsperiode for skovl |
Hvis der er angivet en opbevaringsperiode for bucket, gennemtvinges den længere periode, hvis der både er en opbevaringsperiode på bucketniveau og en opbevaringsperiode på objektniveau. I et miljø, der er aktiveret for overholdelse, er opbevaringsperiode for bucket obligatorisk, medmindre opbevaringsoplysninger i objektet gennemtvinges. Når den er konfigureret, kan bucket-opbevaringsperioden dog ikke nulstilles , selv når opbevaringsoplysninger i objektet gennemtvinges. |
| Minimum fast opbevaringsperiode |
Denne funktion styrer de opbevaringsperioder, der er angivet i objekter. Hvis et objekts opbevaringsperiode ligger uden for de grænser, der er angivet her, mislykkes et forsøg på at skrive objektet. Ved brug af opbevaringspolitikker gennemtvinges min./maks.-indstillingerne ikke. Hvis du vælger Uendelig for Minimum fast opbevaringsperiode , betyder det, at alle opbevaringsværdier skal være uendelige. Hvis du vælger om for Maksimal fast opbevaringsperiode , betyder det, at der ikke er nogen maksimumsgrænse. Min./maks. fastholdelsesbegrænsninger anvendes på enhver C-clip, der skrives til en bucket. Hvis et klip overføres af et SDK-baseret tredjepartsværktøj, skal opbevaringen være inden for grænser, ellers udløses der en fejl. |
| Maksimal fast opbevaringsperiode |
|
| Minimum variabel opbevaringsperiode |
Denne funktion styrer variable opbevaringsperioder, der er angivet i objekter, ved hjælp af hændelsesbaseret. fastholdelse (EBR). I EBR indstilles en basisretentionsperiode, og den programmerede udløserfunktion har mulighed for at øge retentionsperioden, når udløseren udløses. Hvis et objekts nye opbevaringsperiode er uden for de grænser, der er angivet her, mislykkes et forsøg på at skrive objektet som svar på udløseren. Når du bruger opbevaringspolitikker, gennemtvinges min./maks.-indstillingerne ikke . Hvis du vælger Uendelig for Minimum variabel tilbageholdelsesperiode , betyder det, at alle opbevaringsværdier skal være uendelige. Hvis du vælger, om Maksimal variabel opbevaringsperiode er valgt, betyder det, at der ikke er nogen maksimumgrænse. Min./maks. fastholdelsesbegrænsninger anvendes på enhver C-clip, der skrives til en bucket. Hvis et klip overføres af et SDK-baseret tredjepartsværktøj, skal opbevaringen være inden for grænser, ellers udløses der en fejl. |
| Maksimal variabel opbevaringsperiode |
Bemærk: Hvis systemadministratoren eller programmøren ikke har angivet nogen værdier for de faste og
variable opbevaringsperioder, returnerer funktionen ECS Management API get ikke værdier for
min/maks. indstillingerne. Gennemtving opbevaringsoplysninger i C-Clip returnerer standardværdien
false.
Hændelsesbaseret opbevaring
Hændelsesbaseret opbevaring (EBR) er en instruktion, der angiver, at en post ikke kan slettes før en
hændelse og i en angivet periode efter hændelsen. I CAS er EBR en C-Clip med en angivet grundlæggende
opbevaringsperiode eller opbevaringspolitik og en programdefineret udløser, der kan indstille en længere
opbevaringsperiode, når udløseren aktiveres. Opbevaringsperioden begynder først, når udløseren aktiveres.
Når et C-klip er markeret for EBR, kan det ikke slettes før begivenheden, medmindre der bruges en privilegeret sletning
.
Når du bruger EBR, er C-Clips livscyklus som følger:
- Opret: Programmet opretter en ny C-clip og markerer den som værende under EBR. Programmet
kan indeholde en fast opbevaringsperiode, der fungerer som en minimumsopbevaringsperiode, og det skal indeholde en
hændelsesbaseret opbevaringsperiode eller -politik. - Udløserhændelse: Programmet udløser hændelsen, som er udgangspunktet for den hændelsesbaserede
opbevaringsperiode eller opbevaringspolitik. Programmet kan tildele en ny hændelsesbaseret
opbevaringsperiode, hvis den er længere end den, der blev tildelt på tidspunktet for CClip-oprettelsen
. - Slette: Når programmet forsøger at slette C-Clipsen, skal følgende betingelser være opfyldt:
Opbevaring af politik (navneområde) er udløbet
Opbevaring af bucket er udløbet
Fast opbevaring er udløbet
Hændelsen er blevet udløst
Både det EBR, der blev angivet på oprettelsestidspunktet, og eventuelle efterfølgende ændringer (udvidelser) på tidspunktet for hændelsen er udløbet
Følgende figur viser de tre mulige scenarier for en C-Clip under EBR:
- C1 har en fast eller minimal tilbageholdelse, som allerede udløb, før hændelsen blev udløst.
- C2 har en fast eller minimal opbevaring, som udløber, inden EBR udløber.
- C3 har en fast eller minimal opbevaring, som udløber, når EBR udløber.

For ikke-kompatible navneområder kan privilegerede slettekommandoer tilsidesætte fast og variabel
opbevaring for EBR.
Når EBR-opbevaring anvendes, skal den overholde Min/Max Governor-indstillingerne for den variable
opbevaringsperiode.
Tabellen viser CAS API-funktionerne for hændelsesbaseret opbevaring
| Funktion | Beskrivelse |
| FPClip_EnableEBRWithClass | Denne funktion indstiller en C-Clip til at være berettiget til at modtage en fremtidig hændelse og gør det muligt at tildele en hændelsesbaseret fastholdelsesklasse (EBR) til CClip under oprettelsen af C-Clip. |
| FPClip_EnableEBRWithPeriod | Denne funktion indstiller en C-Clip til at være berettiget til at modtage en fremtidig hændelse og gør det muligt at tildele en hændelsesbaseret opbevaringsperiode (EBR) til C-Clip'en under C-Clip-oprettelsestiden. |
| FPClip_IsEBREnabled | Denne funktion returnerer en boolesk værdi for at angive, om en CClip er aktiveret til hændelsesbaseret opbevaring (EBR). |
| FPClip_GetEBRClassName | Denne funktion henter navnet på den hændelsesbaserede opbevaring (EBR). politik, der er tildelt C-klemmen. |
| FPClip_GetEBREventTime | Denne funktion returnerer det hændelsestidspunkt, der blev indstillet på en C-Clip, da hændelsesbaseret fastholdelseshændelse (EBR) for den pågældende C-Clip blev udløst. |
| FPClip_GetEBRPeriod | Denne funktion returnerer værdien (i sekunder) af den hændelsesbaserede opbevaringsperiode (EBR), der er knyttet til en C-Clip. |
| FPClip_TriggerEBREvent | Denne funktion udløser hændelsen i en C-Clip, for hvilken hændelsesbaseret opbevaring (EBR) var aktiveret. |
| FPClip_TriggerEBREventWithClass | Denne funktion udløser hændelsen i en C-Clip, for hvilken hændelsesbaseret opbevaring (EBR) blev aktiveret, og tildeler en ny EBR-politik til CClip. |
| FPClip_TriggerEBREventWithPeriod | Denne funktion udløser hændelsen i en C-Clip, for hvilken hændelsesbaseret opbevaring (EBR) blev aktiveret, og tildeler en ny EBR-periode til CClip. |
Retslig tilbageholdelse
Retslig tilbageholdelse giver CAS-programmer mulighed for midlertidigt at forhindre sletning af en C-Clip. Retslig tilbageholdelse er
nyttig for data, der er genstand for en officiel undersøgelse, stævning eller undersøgelse, og som muligvis ikke slettes
, før undersøgelsen er afsluttet. Når der ikke er behov for at opbevare dataene, kan retslig tilbageholdelse
frigives af applikationen, og normal opbevaringsadfærd genoptages. CAS-programmet
placerer og fjerner en retslig tilbageholdelse på C-Clip-niveau.
Bemærk: Selv en privilegeret sletning kan ikke slette et C-klip under retslig tilbageholdelse.
En C-Clip kan være under flere retssager. Programmet skal generere unikke id er til retslig
tilbageholdelse og kunne spore de specifikke tilbageholdelser af retssager, der er knyttet til en C-Clip.
Programmet kan ikke forespørge en C-Clip om disse oplysninger. Der er kun en funktion, der bestemmer tilstanden for retslig tilbageholdelse af C-Clip
. Hvis der er en eller flere retssager på C-Clip, returnerer denne funktion
sand, ellers er den falsk.
Når du bruger retslig tilbageholdelse, er C-Clips livscyklus som følger:
- Skabe: Programmet opretter en ny C-Clip og tilbyder en fast og/eller hændelsesbaseret
opbevaringsperiode. - Sæt retslig tilbageholdelse i bero: Et program sætter C-Clip på hold. Denne applikation kan være forskellig
fra den applikation, der skrev C-Clip. - Frigivelse af retssager hold: Et program frigiver C-Clipsen. Denne applikation kan være forskellig
fra den applikation, der sætter retssagen i bero eller skrev C-Clip. - Slette: Når programmet forsøger at slette C-Clip, skal følgende betingelser være opfyldt:
Der er ingen andre udestående retssager på C-Clip.
Opbevaring af politik er udløbet.
Standardopbevaring af skovl er udløbet. (Standardopbevaring af skovl er tilgængelig for alle ECS-objekttyper, men anbefales ikke til CAS).
Den faste opbevaringsperiode er udløbet (kun CAS-funktion).
Hændelsesbaseret opbevaring er udløbet (kun CAS-funktion).
Følgende figur viser de tre mulige scenarier for en C-Clip, der er sat under retslig venteposition:
- C1 har en fast opbevaring, der allerede udløb, da den blev sat i bero.
- C2 har en fast opbevaring, der udløber under tilbageholdelsen.
- C3 har en fast tilbageholdelse, der udløber efter frigivelse af tilbageholdelsen.

En C-Clip kan få tildelt flere retstvister. Hvis dette er tilfældet, kræver hver retslig tilbageholdelse
et separat API-kald med et entydigt id for retslig tilbageholdelse.
Bemærk: Den maksimale størrelse på vente-id for retssager er 64 tegn. Det maksimale antal id er
til retslig tilbageholdelse pr. C-Clip er 100. Disse begrænsninger håndhæves af CAS API.
Tabellen viser CAS API-funktionerne for retslig tilbageholdelse
| Funktion | Beskrivelse |
|---|---|
| FPClip_GetRetentionHold | Denne funktion bestemmer C-klemmens holdetilstand og returnerer sand eller falsk. |
| FPClip_SetRetentionHold | Denne funktion indstiller eller nulstiller et fastholdelsesgreb på en C-klemme. Ved flere retslig tilbageholdelse skal du angive et entydigt id for retslig tilbageholdelse for hver tilbageholdelse. Hvis du har flere tilbageholdelser, skal du foretage ét opkald pr. id. |
Additional Information
De CAS-relaterede emner nedenfor er beskrevet i ECS-dataadgangsvejledningen og vil blive opdelt i forskellige KB'er:
- CS: CAS-opbevaring i ECS – KB-538782
- CAS-opbevaring
- Avanceret opbevaring for CAS-programmer: hændelsesbaseret opbevaring, retslig tilbageholdelse og min./maks. regulator
- ECS: Konfigurer politikker for opbevaring af navneområde for CAS – KB 538786
- ECS: Opsætning af bucket ACL er til CAS – KB 538789
- ECS: ECS-administrations-API'er, der understøtter CAS-brugere – KB 538790
- ECS: CAS (Centera) SDK-fejlkoder – KB-427034