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:
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.
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:
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:
En la siguiente figura, se muestran las tres situaciones posibles para un clip C en una 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:
En la siguiente figura, se muestran las tres situaciones posibles para un clip C sometido a retención por litigios:
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: