Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 règle de détection personnalisée écrite dans le cadre du repérage avancé pour reconnaître automatiquement les événements de sécurité lorsqu’ils se produisent et déclencher des alertes et des actions de réponse.
Les règles de détection personnalisées vous permettent de surveiller de manière proactive divers événements et états du système à l’aide de requêtes de repérage avancées , y compris les activités de violation présumées et les points de terminaison mal configurés. Une règle de détection personnalisée reconnaît automatiquement les événements de sécurité lorsqu’ils se produisent et déclenche des alertes et des actions de réponse. Vous pouvez définir les règles pour qu’elles s’exécutent à intervalles réguliers, générant des alertes et effectuant des actions de réponse chaque fois que des correspondances se produisent.
Hérite de l’entité.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | collection microsoft.graph.security.detectionRule | Obtenez une liste des objets detectionRule et leurs propriétés. |
| Create | microsoft.graph.security.detectionRule | Créez un objet detectionRule . |
| Obtenir | microsoft.graph.security.detectionRule | Lire les propriétés et les relations d’un objet detectionRule . |
| Mettre à jour | microsoft.graph.security.detectionRule | Mettez à jour les propriétés d’un objet detectionRule . |
| Supprimer | Aucun | Supprimez un objet detectionRule . |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| createdBy | String | Nom de l’utilisateur ou de l’application qui a créé la règle. En lecture seule. Prend en charge $filter (eq, ne, not, in, startsWith, endsWith, contains). |
| createdDateTime | DateTimeOffset | Horodatage de la création de la règle. En lecture seule. Prend en charge (, , , lenot, ltgegt) et $orderby. neeq$filter |
| description | String | Description fournie par l’utilisateur de la règle de détection. Prend en charge $filter (eq, ne, not, in, startsWith, endsWith, contains). |
| displayName | String | Nom d’affichage de la règle. Prend en charge (, , , innot, endsWithstartsWithcontains) et $orderby. neeq$filter |
| id | String | Identificateur unique de la règle. Hérité de l’entité. Prend en charge (, , notne, in) et $orderby.eq$filter |
| lastModifiedBy | String | Nom de l’utilisateur ou de l’application qui a mis à jour la règle pour la dernière fois. En lecture seule. Prend en charge $filter (eq, ne, not, in, startsWith, endsWith, contains). |
| lastModifiedDateTime | DateTimeOffset | Horodatage de la dernière mise à jour de la règle. En lecture seule. Prend en charge (, , , lenot, ltgegt) et $orderby. neeq$filter |
| queryCondition | microsoft.graph.security.queryCondition | Requête de repérage avancé qui définit la logique de détection de cette règle. Prend en charge $filter sur queryCondition/queryText (chaîne) avec eq, ne, not, inendsWithstartsWithcontains. |
| planifier | microsoft.graph.security.ruleSchedule | Calendrier de déclenchement de cette règle. Prend en charge $filter selon la planification/la fréquence (durée) avec eq, , nenot, ltlegegt. Prend en charge $orderby selon la planification/la fréquence et schedule/nextRunDateTime. |
| status | microsoft.graph.security.detectionRuleStatus | Le status d’exécution actuel de la règle. Les valeurs possibles sont : enabled, disabled, autoDisabled, unknownFutureValue. Prend en charge (, , notne, in) et $orderby.eq$filter |
| detectorId (déconseillé) | String | Identificateur interne du détecteur. Déconseillé. Cette propriété sera supprimée de cette ressource le 2026-10-01. |
| isEnabled (déconseillé) | Booléen | Indique si la règle est activée pour le client. Prend en charge $filter (eq, ne, not). Déconseillé. Utilisez plutôt status. Cette propriété sera supprimée de cette ressource le 2026-10-01. |
| detectionAction | microsoft.graph.security.detectionAction | Les actions effectuées lorsqu’une détection est effectuée par cette règle, y compris l’alerte créée et les actions de réponse automatisées. Prend en charge $filter sur les propriétés alertTemplate imbriquées suivantes :eq, ne, not, inendsWithstartsWithcontains.eq, ne, not, in. |
| lastRunDetails (déconseillé) | microsoft.graph.security.runDetails | Détails de l’exécution du runtime pour l’exécution de règle la plus récente. Prend en charge $filter sur les propriétés imbriquées suivantes :eq, ne, not, inendsWithstartsWithcontains.eq, ne, not, geltlegt.eq, ne, not, in. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.security.detectionRule",
"id": "String (identifier)",
"displayName": "String",
"description": "String",
"status": "String",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedBy": "String",
"lastModifiedDateTime": "String (timestamp)",
"queryCondition": {
"@odata.type": "microsoft.graph.security.queryCondition"
},
"schedule": {
"@odata.type": "microsoft.graph.security.ruleSchedule"
},
"detectionAction": {
"@odata.type": "microsoft.graph.security.detectionAction"
},
"detectorId": "String",
"isEnabled": "Boolean",
"lastRunDetails": {
"@odata.type": "microsoft.graph.security.runDetails"
}
}