Supprimer des données d’audit

Vous devrez peut-être supprimer des données d’audit pour vous conformer à la demande d’un client de supprimer son historique ou pour libérer de l’espace de capacité de journal. Vous ne pouvez pas supprimer directement des enregistrements dans la table Auditing (Audit). Au lieu de cela, Dataverse fournit les messages suivants pour supprimer les données de l’historique d’audit :

Message	Description
DeleteRecordChangeHistory	Supprime tous les enregistrements de l’historique des modifications d’audit pour un enregistrement particulier.
BulkDelete	Supprime de manière asynchrone les enregistrements identifiés par une requête. Utilisez ce message pour supprimer un grand nombre d’enregistrements d’audit sans bloquer d’autres activités.
DeleteAuditData	Pour les clients utilisant des clés de chiffrement gérées par le client, supprime tous les enregistrements de données d’audit jusqu’à une date de fin spécifiée.

Notes

Cet article fournit des instructions pour supprimer des données personnelles de l’appareil ou du service et peut vous aider à respecter vos obligations en vertu du RGPD. Pour des informations générales sur le RGPD, consultez la section RGPD du Centre de gestion de la confidentialité Microsoft et la section RGPD du portail d’approbation de services.

Supprimer l’historique des modifications pour un enregistrement

Utilisez le message DeleteRecordChangeHistoryRequest pour supprimer tous les enregistrements de l’historique des modifications d’audit pour un enregistrement particulier plutôt que tous les enregistrements d’audit pour une plage de dates.

Pour supprimer l’historique des modifications d’audit d’un enregistrement, vous devez avoir un rôle de sécurité Administrateur système ou un rôle de sécurité avec le privilège prvDeleteRecordChangeHistory.

Message DeleteRecordChangeHistoryRequest

Utilisez le paramètre Target pour préciser l’enregistrement. La propriété DeletedEntriesCount de la réponse vous indique combien d’enregistrements d’audit ont été supprimés.

API web

L’exemple suivant utilise l’Action DeleteRecordChangeHistory pour supprimer les modifications de données auditées pour un enregistrement de compte.

Demande :

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"
 }
}

Réponse :

HTTP/1.1 200 OK
OData-Version: 4.0

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

En savoir plus sur :

• Utiliser des actions API Web.
• Action DeleteRecordChangeHistory
• DeleteRecordChangeHistoryResponse ComplexType

SDK pour .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}");
}

En savoir plus sur :

• Classe DeleteRecordChangeHistoryRequest
• Classe DeleteRecordChangeHistoryResponse
• Méthode IOrganizationService.Execute

Utiliser BulkDelete pour supprimer les données d’audit

Utilisez le message BulkDelete pour supprimer les enregistrements d’audit que votre organisation n’a plus besoin de conserver pour se conformer aux exigences d’audit interne et externe. L’opération de suppression en bloc s’exécute en arrière-plan et vous permet de définir des modèles de récurrence, l’heure de début et d’autres paramètres.

Message BulkDelete

L’exemple suivant supprime les enregistrements d’audit avec une valeur d’action de 64 (accès utilisateur via le Web).

API web

Demande :

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"
}

Réponse :

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]"
}

En savoir plus sur :

• Action BulkDelete
• BulkDeleteResponse ComplexType
• QueryExpression ComplexType

SDK pour .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);
    }
}

En savoir plus sur :

• Classe BulkDeleteRequest
• Classe BulkDeleteResponse
• Méthode IOrganizationService.Execute
• Méthode IOrganizationService.Retrieve

Supprimer l’historique des modifications pour une plage de dates

Si vous utilisez des clés de chiffrement gérées par le client, vous pouvez utiliser le message DeleteAuditData pour supprimer les enregistrements d’audit pour une plage de dates. Les enregistrements de données d’audit sont supprimés séquentiellement du plus ancien au plus récent.

Notes

Même si vous utilisez des clés de chiffrement gérées par le client, vous devriez envisager d’utiliser la suppression en bloc plutôt que le message DeleteAuditData.

Le message DeleteAuditData supprime toutes les données d’audit de ces partitions où la date de fin est antérieure à la date spécifiée dans la propriété EndDate. Toutes les partitions vides sont également supprimées. La partition en cours (active) et les enregistrements y figurant ne peuvent être supprimés à l’aide de cette demande ou d’une autre demande.

Dataverse crée automatiquement des partitions tous les trimestres. Vous ne pouvez pas modifier ou interrompre ce comportement. Vous pouvez utiliser le message RetrieveAuditPartitionList pour obtenir la liste des partitions. Si la date de fin d’une partition est ultérieure à la date en cours, vous ne pouvez pas supprimer cette partition ou les enregistrements d’audit qu’elle contient.

Voir aussi

Présentation de l’audit
Configurer l’audit
Extraire l’historique de modifications de données auditées
Guide de l’administrateur : Libérer de l’espace de base de données en supprimant les journaux d’audit

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).