Eliminar datos de auditoría

Es posible que deba eliminar datos de auditoría para cumplir con la solicitud de un cliente de eliminar su historial o liberar espacio de capacidad de registro. No puede eliminar registros directamente en la Tabla de auditoría (Audit). En su lugar, Dataverse proporciona los siguientes mensajes para eliminar los datos del historial de auditoría:

Mensaje	Descripción
DeleteRecordChangeHistory	Elimina todos los registros del historial de cambios de auditoría para un registro determinado.
BulkDelete	Elimina de forma asincrónica los registros identificados por una consulta. Use este mensaje para eliminar una gran cantidad de registros de auditoría sin bloquear otras actividades.
DeleteAuditData	Para los clientes que utilizan claves de cifrado gestionadas por el cliente, elimina todos los registros de datos de auditoría hasta una fecha de finalización especificada.

Nota

En este artículo, se proporcionan instrucciones para eliminar datos personales desde el dispositivo o servicio y puede ayudarle a cumplir con sus obligaciones según el RGPD. Para obtener información general sobre el RGPD, consulte la Sección de RGPD del Centro de confianza de Microsoft y la Sección de RGPD del portal de confianza de servicios.

Eliminar el historial de cambios para un registro

Use el mensaje DeleteRecordChangeHistoryRequest para eliminar todos los registros del historial de cambios de auditoría para un registro en particular en lugar de todos los registros de auditoría para un rango de fechas.

Para eliminar el historial de cambios de auditoría de un registro, debe tener el rol de seguridad Administrador del sistema o un rol de seguridad con el privilegio prvDeleteRecordChangeHistory.

Mensaje DeleteRecordChangeHistoryRequest

Use el parámetro Target para especificar el registro. La propiedad DeletedEntriesCount de la respuesta le indica cuántos registros de auditoría se eliminaron.

API web

El siguiente ejemplo usa la Acción DeleteRecordChangeHistory para eliminar los cambios de datos auditados para un registro de cuenta.

Solicitud:

POST [Organization URI]/api/data/v9.2/DeleteRecordChangeHistory HTTP/1.1
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

{
 "Target": {
  "@odata.type": "Microsoft.Dynamics.CRM.account",
  "accountid": "611e7713-68d7-4622-b552-85060af450bc"
 }
}

Respuesta:

HTTP/1.1 200 OK
OData-Version: 4.0

{
 "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.DeleteRecordChangeHistoryResponse",
 "DeletedEntriesCount": 4
}

Más información sobre:

• Usar acciones de la API web.
• Acción DeleteRecordChangeHistory
• ComplexType DeleteRecordChangeHistoryResponse

SDK para .NET

/// <summary>
/// Deletes record change history for a specific record and shows
/// how many records were deleted.
/// </summary>
/// <param name="svc">The IOrganizationService instance to use.</param>
/// <param name="target">The specified record.</param>
static void ShowDeleteRecordChangeHistory(
IOrganizationService svc, 
EntityReference target) 
{
    var req = new DeleteRecordChangeHistoryRequest { 
        Target = target
    };

    var resp = (DeleteRecordChangeHistoryResponse)
               svc.Execute(req);

    Console.WriteLine($"Audit records deleted:{resp.DeletedEntriesCount}");
}

Más información sobre:

• Clase DeleteRecordChangeHistoryRequest
• Clase DeleteRecordChangeHistoryResponse
• Método IOrganizationService.Execute

Use BulkDelete para eliminar datos de auditoría

Use el mensaje BulkDelete para eliminar los registros de auditoría que su organización ya no necesita conservar para cumplir con los requisitos de auditoría internos y externos. La operación de eliminación masiva se ejecuta en segundo plano y le permite definir patrones de recurrencia, hora de inicio y otros parámetros.

Mensaje BulkDelete

El siguiente ejemplo elimina registros de auditoría con un valor de acción de 64 (Acceso de usuario a través de la Web).

API web

Solicitud:

POST [Organization URI]/api/data/v9.1/BulkDelete
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0  

{
 "QuerySet": [
  {
   "EntityName": "audit",
   "Criteria": {
    "FilterOperator": "And",
    "Conditions": [
     {
      "AttributeName": "action",
      "Operator": "Equal",
      "Values": [
       {
        "Type": "System.String",
        "Value": "64"
       }
      ]
     }
    ],
    "Filters": []
   }
  }
 ],
 "JobName": "Bulk Delete of audit records with action = 64",
 "SendEmailNotification": false,
 "ToRecipients": [],
 "CCRecipients": [],
 "RecurrencePattern": "",
 "StartDateTime": "2022-02-02T10:00:00.000Z"
}

Respuesta:

HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
 "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.BulkDeleteResponse",
 "JobId": "[Job Id]"
}

Más información sobre:

• Acción BulkDelete
• ComplexType BulkDeleteResponse
• ComplexType QueryExpression

SDK para .NET

/// <summary>
/// Creates a BulkDelete job to delete audit record history for a 
/// specific action and shows the job created.
/// </summary>
/// <param name="svc">IOrganizationService to use</param>
/// <param name="actionValue">The audit action value</param>
static void BulkDeleteAuditHistoryByAction(IOrganizationService svc, int actionValue)
{
    Guid jobId;

    var querySet = new QueryExpression(entityName: "audit");
    querySet.Criteria.AddCondition(
        attributeName: "action",
        conditionOperator: ConditionOperator.Equal,
        values: actionValue);

    var req = new BulkDeleteRequest
    {
        QuerySet = new QueryExpression[] { querySet },
        JobName = $"Bulk Delete of audit records with action = {actionValue}",
        SendEmailNotification = false,
        ToRecipients = new Guid[] { },
        CCRecipients = new Guid[] { },
        RecurrencePattern = string.Empty,
        StartDateTime = DateTime.UtcNow
    };

    try
    {
        var resp = (BulkDeleteResponse)svc.Execute(req);
        jobId = resp.JobId;

        Entity bulkDeleteJob =
            svc.Retrieve(
                entityName: "asyncoperation",
                id: jobId,
                columnSet: new ColumnSet("name", "statecode", "statuscode"));

        Console.WriteLine($"Job Name: {bulkDeleteJob["name"]}");
        Console.WriteLine($"Job Id: {bulkDeleteJob.Id}");
        Console.WriteLine($"State: {bulkDeleteJob.FormattedValues["statecode"]}");
        Console.WriteLine($"Status: {bulkDeleteJob.FormattedValues["statuscode"]}");

    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
}

Más información sobre:

• Clase BulkDeleteRequest
• Clase BulkDeleteResponse
• Método IOrganizationService.Execute
• Método IOrganizationService.Retrieve

Eliminar el historial de cambios para un intervalo de fechas

Si usa claves de encriptación administradas por el cliente, puede usar el mensaje DeleteAuditData para eliminar registros de auditoría para un intervalo de fechas. Los registros de datos de auditoría se eliminan de forma secuencial, del más antiguo al más nuevo.

Nota

Incluso si está utilizando claves de cifrado administradas por el cliente, debería considerar usar Eliminación masiva en lugar del mensaje DeleteAuditData.

El mensaje DeleteAuditData elimina todos los datos de auditoría en las particiones donde la fecha de finalización es anterior a la fecha especificada en la propiedad EndDate. Ninguna de las particiones vacías puede eliminarse. La partición actual (activa) y los registros de auditoría en ella no pueden eliminarse mediante esta solicitud o cualquier otra solicitud.

Dataverse crea particiones automáticamente cada trimestre. Este comportamiento no se puede cambiar o detener. Puede usar el mensaje RetrieveAuditPartitionList para obtener la lista de particiones. Si la fecha de finalización de cualquier partición es posterior a la fecha actual, no podrá eliminar esa partición o los registros de auditoría que contenga.

Consulte también

Información general de auditoría
Configurar auditoría
Recuperar el historial de cambios de datos auditados
Guía de administradores: Recuperación de espacio en la base de datos mediante la eliminación de registros de auditoría

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).