ECS: Retención de CAS en ECS

Retención de CAS en ECS

Un clip C de CAS puede tener un período de retención que rige la cantidad de tiempo. El objeto asociado se conserva en el almacenamiento de ECS antes de que una aplicación pueda eliminarlo.


Períodos de retención

La aplicación de CAS asigna períodos de retención en el clip C para el objeto.

Por ejemplo, si un documento financiero se debe conservar durante tres años a partir de su fecha de creación, se especifica un
período de retención de tres años en el clip C asociado con el documento financiero. También es
posible especificar que el documento se conserve indefinidamente.

Políticas de retención (clases de retención)

Nota: El concepto de clases de retención de Centera se asigna a las políticas de retención en ECS. En esta
documentación, se utilizan políticas de retención.

Las políticas de retención permiten capturar y aplicar casos de uso de retención a clips C. Por ejemplo,
diferentes tipos de documentos podrían tener diferentes períodos de retención. Puede requerir los
siguientes períodos de retención:

• Financiera: 3 años
• Legal: 5 años
• Email (Correo electrónico): 6 meses

Cuando se aplica una política de retención a varios clips C con un cambio de política, el período de retención
cambia para todos los objetos a los que se aplica la política.

Las políticas de retención están asociadas con espacios de nombres en ECS, y la aplicación de CAS
las reconoce como clases de retención.
 

CAS y retención en el nivel de depósito de ECS

La retención en el nivel de depósito no es la retención predeterminada del pool en Centera. En ECS, la retención predeterminada de CAS es
constantemente cero.
 

Período de retención predeterminado en objetos escritos sin retención a nivel de objeto en espacios de nombres de cumplimiento
de normas.

A partir de ECS 3.0, cuando una aplicación escribe clips C sin retención de objetos en un depósito de CAS
de ECS en un espacio de nombres de cumplimiento de normas y el depósito tiene un valor de retención (6 meses, por ejemplo),
el período de retención predeterminado de infinito (-1) se asignará a los clips C. Los clips C nunca
se pueden eliminar porque su período de retención real es el más largo entre los dos: el
período de retención a nivel de depósito y la retención predeterminada en el nivel de objeto.
 

Prioridad de CAS

Cuando se aplican varios períodos de retención a un objeto de CAS en ECS, el período de retención con el
valor más alto tiene prioridad, independientemente de cómo se haya aplicado la retención.
 

Cómo aplicar la retención de CAS

Puede definir políticas de retención para espacios de nombres en el portal de ECS o con la API de administración de
ECS. Consulte Configuración de políticas de retención de espacio de nombres.

La aplicación de CAS externa puede asignar un período de retención fijo o una política de retención al clip C
durante su creación.

Cuando aplique períodos de retención mediante API, especifique el período en segundos.

Nota: CAS de ECS toma el tiempo de creación del clip C para todos los cálculos relacionados con la retención y
no el tiempo de migración.

Cómo crear políticas de retención con la API de administración de ECS.

Puede crear períodos de retención y políticas mediante ECS, cuyo resumen se proporciona
a continuación.

Método	Descripción
PUT /object/bucket/{bucketName}/retention	El valor de retención para un depósito define un período de retención obligatorio que se aplica a cada objeto dentro de un depósito. Si establece un período de retención de 1 año, no se puede eliminar un objeto del depósito durante un año.
GET /object/bucket/{bucketName}/retention	Devuelve el período de retención que está configurado actualmente para un depósito especificado.
POST /object/namespaces/namespace/{namespace}/ retention	Para los espacios de nombres, la configuración de retención actúa como una política, donde cada política es un par <Name>:<Retention period>. Puede definir varias políticas de retención para un espacio de nombres y puede asignar una política, por nombre, a un objeto dentro del espacio de nombres. Esto le permite cambiar el período de retención de un conjunto de objetos que tienen la misma política asignada mediante el cambio de la política correspondiente .
PUT /object/namespaces/namespace/{namespace}/ retention/{class}	Actualiza el período de un período de retención asociado con un espacio de nombres.
GET /object/namespaces/namespace/{namespace}/ retention	Devuelve la política de retención definida para un espacio de nombres.

Puede encontrar más información acerca de la API de administración de ECS en la introducción de la
API REST de administración de ECS en la Guía de acceso a datos de ECS. La referencia en línea se encuentra aquí: Referencia de la API de ECS.

Retención avanzada para aplicaciones de CAS: retención basada en eventos, retención por litigios y regulador mín./máx.

Describe las funciones de retención avanzadas disponibles en la API de CAS compatibles con ECS.

Las aplicaciones del cliente utilizan la API de CAS para habilitar las estrategias de retención. Cuando las cargas de trabajo de CAS se
migran a ECS, el reconocimiento de ECS de las funciones de la API de CAS permite que las aplicaciones del cliente continúen
trabajando con los datos migrados. En ECS, las siguientes funciones de administración de retención avanzada (ARM)
están disponibles sin una licencia independiente:

• Retención basada en eventos: la capacidad de configurar un objeto a través de su clip C para aplicar (activar) un período de retención o una
  política de retención cuando la aplicación de CAS recibe un evento especificado.
• Retención por litigios: La capacidad de evitar la eliminación de un objeto si la aplicación de CAS aplicó una
  retención por litigios al objeto a través de su clip C. La aplicación de CAS puede aplicar hasta 100
  retenciones por litigios a un objeto mediante la creación y la aplicación de ID únicos de retención por litigios.
• Regulador mín./máx.: La capacidad de un administrador de establecer límites en el nivel de depósito para un período de retención
  fijo o variable. Un período de retención variable es aquel que se configura para admitir
  la retención basada en eventos. En ECS, los administradores del sistema o del espacio de nombres pueden establecer los valores con el portal de ECS
  . Los programadores pueden usar la API de administración de ECS para establecer los valores.

Nota: La ARM es compatible con los datos de CAS heredados escritos con cualquier esquema de asignación de nombres que se migre
a ECS.

Regulador mín./máx. para retención a nivel de depósito de CAS

En el portal de ECS, busque un depósito de CAS y seleccione Edit. Todas las funciones que se muestran en la siguiente pantalla
son solo de CAS, excepto la función Bucket Retention Period. Bucket Retention
Period es la función de retención de depósitos estándar de ECS admitida en todos los tipos de depósitos de ECS.

Las funciones de retención del depósito de CAS se explican en la siguiente tabla.
 

Característica	Descripción
Enforce Retention	Si esta función está activada, no se puede crear ningún objeto de CAS sin información de retención (período o política). Si intenta guardar este objeto, arroja un error. Si está activado, es posible no configurar Bucket Retention Period, incluso en un ambiente habilitado para el cumplimiento de normas. Nota: Cuando se migra Centera de un modo CE+ a ECS, se activa Enforce Retention de manera predeterminada en el depósito.
Bucket Retention Period	Si se especifica un período de retención de depósito, se aplica el período más largo si hay un período de retención a nivel de depósito y de objetos. En un ambiente habilitado para el cumplimiento de normas, Bucket Retention Period es obligatorio, a menos que se aplique la información de retención en el objeto. Sin embargo, una vez configurado, Bucket Retention Period no se puede restablecer incluso cuando se aplica la información de retención en el objeto.
Minimum Fixed Retention Period	Esta función controla los períodos de retención especificados en los objetos. Si el período de retención de un objeto está fuera de los límites especificados aquí, se produce un error en el intento de escribir el objeto. Con las políticas de retención, no se aplican los ajustes mín./máx. Seleccionar Infinite para Minimum Fixed Retention Period significa que todos los valores de retención deben ser infinitos. Seleccionarlo para Maximum Fixed Retention Period significa que no hay un límite máximo. Las restricciones de retención mín./máx. se aplican a cualquier clip C escrito en un depósito. Si una herramienta de terceros basada en SDK migra un clip, la retención debe estar dentro de los límites; de lo contrario, se produce un error.
Maximum Fixed Retention Period
Minimum Variable Retention Period	Esta función controla los períodos de retención variables especificados en objetos mediante el uso de retenciones basadas en eventos (EBR). En EBR, se establece un período de retención base y la función de activación programada tiene la capacidad de aumentar el período de retención cuando se habilita la activación. Si el nuevo período de retención de un objeto está fuera de los límites especificados aquí, se produce un error en el intento de escribir el objeto en respuesta a la falla de la activación. Cuando se utilizan políticas de retención, no se aplica el ajuste mín./máx. Seleccionar Infinite para Minimum Variable Retention Period significa que todos los valores de retención deben ser infinitos. Seleccionarlo para Maximum Variable Retention Period significa que no hay un límite máximo. Las restricciones de retención mín./máx. se aplican a cualquier clip C escrito en un depósito. Si una herramienta de terceros basada en SDK migra un clip, la retención debe estar dentro de los límites; de lo contrario, se produce un error.
Maximum Variable Retention Period

Nota: Si el administrador del sistema o el programador no han establecido valores para los períodos de retención fijos y
variables, la función get de la API de administración de ECS no devolverá valores para
los ajustes mín./máx. Enforce Retention Information in C-Clip devolverá un valor predeterminado
de falso.
 

Retención basada en eventos

La retención basada en eventos (EBR) es una instrucción que especifica que un registro no se puede eliminar antes de un
evento y durante un período especificado después del evento. En CAS, la EBR es un clip C con un período de retención base
o una política de retención especificados y un activador definido por la aplicación que puede establecer un período de retención más largo
cuando se activa. El período de retención solo comienza cuando se habilita el activador.
Cuando un clip C está marcado para EBR, no se puede eliminar antes del evento, a menos que se utilice una eliminación
con privilegios.

Cuando se utiliza la EBR, el ciclo de vida del clip C es el siguiente:

• Creación: la aplicación crea un clip C nuevo y lo marca como parte de la EBR. La aplicación
  puede proporcionar un período de retención fijo que actúa como una retención mínima y debe proporcionar un
  período de retención basado en eventos o una política.
• Evento activador: La aplicación activa el evento, que es el punto de inicio del período de retención basado en
  eventos o la política de retención. La aplicación, puede asignar un nuevo período de retención basado en
  eventos, si es más largo que el asignado en el momento de la creación del clip C
  .
• Delete: Cuando la aplicación intenta eliminar el clip C, se deben cumplir las siguientes condiciones:
  La retención de políticas (espacio de nombres) está vencida
  La retención del depósito está vencida
  La retención fija está vencida
  El evento se activó
  Tanto el conjunto de EBR en el momento de la creación como los cambios subsiguientes (extensiones) en el momento del evento están vencidos

En la siguiente figura, se muestran las tres situaciones posibles para un clip C en una EBR:

• C1 tiene una retención fija o mínima que ya venció antes de que se activara el evento.
• C2 tiene una retención fija o mínima que vencerá antes de que venza la EBR.
• C3 tiene una retención fija o mínima que vencerá después de que venza la EBR.

 

Para espacios de nombres no compatibles, los comandos de eliminación con privilegios pueden reemplazar la retención fija y variable
para EBR.

Cuando se aplica una EBR, debe cumplir con la configuración de regulador mín./máx. para el período de retención variable
.

En la tabla, se muestran las funciones de la API de CAS para la retención basada en eventos

Función	Descripción
FPClip_EnableEBRWithClass	Esta función establece un clip C para ser elegible para recibir un evento futuro y permite que una clase de EBR se asigne al clip C durante el tiempo de creación del clip C.
FPClip_EnableEBRWithPeriod	Esta función establece un clip C para ser elegible para recibir un evento futuro y permite que un período de EBR se asigne al clip C durante el tiempo de creación del clip C.
FPClip_IsEBREnabled	Esta función devuelve un valor booleano para indicar si un clip C está habilitado o no para la EBR.
FPClip_GetEBRClassName	Esta función recupera el nombre de la retención basada en eventos (EBR): política asignada al clip C.
FPClip_GetEBREventTime	Esta función devuelve la hora del evento establecida en un clip C cuando se activó el evento de EBR para ese clip C.
FPClip_GetEBRPeriod	Esta función devuelve el valor (en segundos) del período de la retención basada en eventos (EBR) asociado con un clip C.
FPClip_TriggerEBREvent	Esta función activa el evento de un clip C para el cual se habilitó la retención basada en eventos (EBR) .
FPClip_TriggerEBREventWithClass	Esta función activa el evento de un clip C para el cual se habilitó la retención basada en eventos (EBR) y asigna una nueva política de EBR al clip C.
FPClip_TriggerEBREventWithPeriod	Esta función activa el evento de un clip C para el cual se habilitó la retención basada en eventos (EBR) y asigna un nuevo período de EBR al clip C.

 

 

Retención por litigios

La retención por litigios permite que las aplicaciones de CAS eviten temporalmente la eliminación de un clip C. La retención por litigios es
útil para los datos que están sujetos a una investigación oficial, citación o indagación, y que no se
pueden eliminar hasta que finalice la investigación. Una vez que no es necesario conservar los datos, la aplicación puede liberar la retención
por litigios, y se reanuda el comportamiento de retención normal. La aplicación
de CAS coloca y elimina una retención por litigios en el nivel de clip C.

Nota: Incluso una eliminación con privilegios no puede eliminar un clip C en retención por litigios.

Un clip C puede estar bajo varias retenciones por litigios. La aplicación debe generar ID únicos de retención por litigios
y ser capaz de rastrear las retenciones por litigios específicas asociadas con un clip C. La aplicación
no puede consultar un clip C para obtener esta información. Solo hay una función que determina el estado de retención por litigios
del clip C. Si hay una o varias retenciones por litigios en el clip C, esta función
arroja un resultado verdadero; de lo contrario, es falso.

Cuando se utiliza la retención por litigios, el ciclo de vida del clip C es el siguiente:

• Creación: La aplicación crea un clip C nuevo y proporciona un período de retención fijo o basado en
  eventos.
• Establecimiento de retención por litigios: Una aplicación pone el clip C en retención. Esta aplicación puede ser diferente
  de la aplicación que escribió el clip C.
• Liberación de la retención por litigios: Una aplicación libera el clip C. Esta aplicación puede ser diferente
  de la aplicación que estableció la retención por litigios o escribió el clip C.
• Delete: Cuando la aplicación intenta eliminar el clip C, se deben cumplir las siguientes condiciones:
  No debe haber otras retenciones pendientes por litigios en el clip C.
  La retención de políticas debe estar vencida.
  La retención del depósito estándar debe estar vencida. (La retención de depósito estándar está disponible para todos los tipos de objetos de ECS, pero no se recomienda para CAS).
  El período de retención fijo debe estar vencido (función solo de CAS).
  La retención basada en eventos debe estar vencida (función solo de CAS).

En la siguiente figura, se muestran las tres situaciones posibles para un clip C sometido a retención por litigios:

• C1 tiene una retención fija que ya venció cuando se pone en retención.
• C2 tiene una retención fija que vence durante la retención.
• C3 tiene una retención fija que vencerá después de la liberación de la retención.

Un clip C puede tener varias retenciones por litigios asignadas. Si este es el caso, cada retención
por litigios requiere una llamada de API independiente con un identificador único para la retención por litigios.

Nota: El tamaño máximo del ID de retención por litigios es de 64 caracteres. La cantidad máxima de ID de retención por litigios
por clip C es 100. La API de CAS aplica estas limitaciones.

En la tabla, se muestran las funciones de la API de CAS para retención por litigios.
 

Función	Descripción
FPClip_GetRetentionHold	Esta función determina el estado de retención del clip C y arroja un resultado verdadero o falso.
FPClip_SetRetentionHold	Esta función establece o restablece una retención en un clip C. Para varias retenciones por litigios, proporcione un ID de retención por litigios único para cada retención. Para varias retenciones, realice una llamada por ID.

Los temas relacionados con CAS a continuación se detallan en la Guía de acceso a datos de ECS y se dividen en diferentes bases de conocimientos:

• ECS: Configuración del soporte de CAS en ECS: base de conocimientos n.º 538783
  • Configuración del soporte de CAS en ECS
  • Almacenamiento inactivo
• ECS: Cumplimiento de normas de CAS: base de conocimientos n.º 538784
  • Cumplimiento de normas y fortalecimiento de la plataforma
  • Política de cumplimiento de normas y retención
  • Agente de cumplimiento de normas
• ECS: Retención de CAS en ECS: base de conocimientos n.º 538782
  • Retención de CAS
  • Retención avanzada para aplicaciones de CAS: retención basada en eventos, retención por litigios y regulador mín./máx.
• ECS: Configuración de políticas de retención de espacio de nombres para CAS: base de conocimientos n.º 538786
• ECS: Prácticas recomendadas de administración de usuarios y depósitos de CAS: base de conocimientos n.º 478327
  • Crear y configurar un depósito para un usuario de CAS
  • Configurar un usuario de objetos de CAS
• ECS: Configuración de ACL de depósito para CAS: base de conocimientos n.º 538789
• ECS: API de administración de ECS que admiten usuarios de CAS: base de conocimientos n.º 538790
• ECS: Soporte de la API de SDK de almacenamiento direccionable por contenido (CAS): kb 538791
• ECS: Códigos de error de SDK de CAS (Centera): base de conocimientos n.º 427034