type de ressource auditLogQuery

Espace de noms : microsoft.graph.security

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente une requête du journal d’audit utilisée pour interroger et récupérer les enregistrements du journal d’audit pertinents.

Hérite de microsoft.graph.entity.

Méthodes

Méthode Type de retour Description
Répertorier les auditLogQueries collection auditLogQuery Obtenez une liste des objets auditLogQuery et de leurs propriétés.
Créer auditLogQuery auditLogQuery Créez un objet auditLogQuery .
Obtenir auditLogQuery auditLogQuery Lire les propriétés et les relations d’un objet auditLogQuery .
Lister les enregistrements collection auditLogRecord Obtenez les ressources auditLogRecord à partir de la propriété de navigation des enregistrements.

Propriétés

Propriété Type Description
administrativeUnitIdFilters String collection Unités administratives associées à un enregistrement de journal d’audit.
approximateReturnedRecordCount Int64 Nombre approximatif d’enregistrements récupérés par la requête. Cette valeur peut être supérieure ou inférieure à recordCountLimit en raison du comptage distribué. En lecture seule.
displayName String Nom d’affichage de la requête du journal d’audit enregistrée.
filterEndDateTime DateTimeOffset Date de fin de la plage de dates de la requête.
filterStartDateTime DateTimeOffset Date de début de la plage de dates de la requête.
id String Identificateur unique pour la requête du journal d’audit. Hérité de microsoft.graph.entity.
ipAddressFilters String collection Adresse IP du périphérique utilisé lors de la journalisation de l’activité.
isRecordCountLimitExceeded Booléen Indique si la requête a dépassé la limite du nombre d’enregistrements par recherche. La valeur par défaut est false. La valeur de true fait autorité et n’est pas dérivée de approximateReturnedRecordCount. En lecture seule.
mot-cléFiltre String Texte libre à comparer au contenu non indexé de chaque enregistrement : propriétés spécifiques à la charge de travail dans auditData, y compris son AppAccessContext objet. Les propriétés de schéma commun indexées, telles que le nom de l’opération, ne sont pas mises en correspondance par le mot clé ; utilisez leurs propres filtres, tels que operationFilters, pour celles-ci.
objectIdFilters String collection Pour l’activité SharePoint et OneDrive Entreprise, il s’agit du nom du chemin d’accès complet au fichier ou au dossier consulté par l’utilisateur. Pour la journalisation d’audit d’administration Exchange, il s’agit du nom de l’objet modifié par la cmdlet.
operationFilters String collection Nom de l’activité de l’utilisateur ou de l’administrateur. Pour consulter la description des opérations/activités les plus courantes, reportez-vous à l’article relatif à la recherche dans le journal d’audit dans le Centre de sécurité et conformité d’Office 365.
recordCountLimit Int64 Seuil de nombre d’enregistrements utilisé pour limiter l’extraction des résultats de la requête. En lecture seule.
recordTypeFilters microsoft.graph.security.auditLogRecordType collection Type d’opération indiqué par l’enregistrement. Pour obtenir la liste des valeurs de membre, consultez auditLogRecordType.
serviceFilter String Fait référence à la propriété de charge de travail dans l’enregistrement de vérification. Il s’agit du service Microsoft dans lequel l’activité s’est produite. Facultatif.
status microsoft.graph.security.auditLogQueryStatus Décrit le status actuel de la requête. Les valeurs possibles sont notStarted, running, succeeded, failed, cancelled, unknownFutureValue.
userPrincipalNameFilters String collection L’UPN (nom d’utilisateur principal) de l’utilisateur qui a effectué l’action (spécifiée dans la propriété d’opération) qui a entraîné la journalisation de l’enregistrement ; Par exemple, my_name@my_domain_name.

Remarque

Une requête du journal d’audit peut se terminer correctement après avoir dépassé sa limite de nombre d’enregistrements. Utilisez isRecordCountLimitExceeded pour déterminer si la limite a été dépassée. Pour plus d’informations sur les allocations de locataire et par requête, voir Limites de limitation spécifiques au service Microsoft Graph.

Relations

Relation Type Description
records (en anglais) microsoft.graph.security.auditLogRecord collection Un enregistrement de journal d’audit individuel.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.security.auditLogQuery",
  "id": "String (identifier)",
  "displayName": "String",
  "filterStartDateTime": "String (timestamp)",
  "filterEndDateTime": "String (timestamp)",
  "recordTypeFilters": [
    "String"
  ],
  "keywordFilter": "String",
  "serviceFilter": "String",
  "operationFilters": [
    "String"
  ],
  "userPrincipalNameFilters": [
    "String"
  ],
  "ipAddressFilters": [
    "String"
  ],
  "objectIdFilters": [
    "String"
  ],
  "administrativeUnitIdFilters": [
    "String"
  ],
  "status": "String",
  "isRecordCountLimitExceeded": "Boolean",
  "recordCountLimit": "Int64",
  "approximateReturnedRecordCount": "Int64"
}
  • Dernière mise à jour :