type de ressource configurationMonitor

Espace de noms: microsoft.graph

Représente des moniteurs pour la surveillance des locataires ou des dérives sur toutes les charges de travail prises en charge par la gestion de la configuration du locataire, ce qui permet la détection périodique des écarts par rapport à l’état de configuration souhaité.

Hérite de l’entité.

Méthodes

Méthode Type de retour Description
List collection configurationMonitor Obtenez la liste des objets configurationMonitor et de leurs propriétés.
Create configurationMonitor Créez un objet configurationMonitor qui s’exécute régulièrement en arrière-plan à une fréquence planifiée.
Obtenir configurationMonitor Obtient les propriétés et les relations d’un objet configurationMonitor .
Mettre à jour configurationMonitor Mettez à jour les propriétés d’un objet configurationMonitor , y compris le nom, la description et la base de référence du moniteur.
Supprimer Aucun Supprimez définitivement un objet configurationMonitor .
Obtenir la base de référence de configuration collection configurationBaseline Lisez les propriétés et les relations d’un objet configurationBaseline attaché à un moniteur spécifique.

Propriétés

Propriété Type Description
createdBy identitySet L’utilisateur, l’application ou l’appareil qui a créé le moniteur.

Nécessite $select la récupération. Prend en charge $filter (eq).
createdDateTime DateTimeOffset Date et heure de création du moniteur. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.

Prend en charge $filter (eq, ne, ge, le) et $orderby.
description String Description conviviale du moniteur fourni par l’utilisateur.

Prend en charge $filter (eq, ne, startsWith) et $orderby.
displayName String Nom convivial donné par l’utilisateur au moniteur.

Prend en charge $filter (eq, ne, startsWith) et $orderby.
id String Identificateur global unique (GUID) pour le moniteur. Généré par le système. Hérité de l’entité.

Prend en charge $filter (eq, ne) et $orderby.
inactivationReason String Raison de l’inactivation du moniteur.

Nécessite $select la récupération.
lastModifiedBy identitySet L’utilisateur, l’application ou l’appareil qui a modifié le moniteur pour la dernière fois.

Nécessite $select la récupération. Prend en charge $filter (eq).
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification du moniteur. Si aucune modification n’est apportée au moniteur, il est identique à createdDateTime. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.

Prend en charge $filter (eq, ne, ge, le) et $orderby.
mode monitorMode Mode de surveillance dans lequel le moniteur s’exécute. Les valeurs possibles sont : monitorOnly, unknownFutureValue. La valeur par défaut est monitorOnly.

Prend en charge $filter (eq, ne).
monitorRunFrequencyInHours Int32 Fréquence à laquelle le moniteur s’exécute. La fréquence par défaut est de six heures. Quel que soit le moment où vous créez ou mettez à jour un moniteur, il est déclenché dans les 6 prochaines heures. Actuellement, les moniteurs sont récupérés à des heures fixes : 6 h, 12 h, 18 h et 12 h (tous en GMT). Par exemple, si vous créez un moniteur à 9h00, il est déclenché vers 12h00. Si vous mettez à jour un moniteur à 16h00, il est déclenché vers 18h.
paramètres openComplexDictionaryType Paires clé-valeur qui contiennent des valeurs de paramètre qui peuvent être utilisées dans la base de référence.

Nécessite $select la récupération.
status monitorStatus État du moniteur. Les valeurs possibles sont active, inactive, unknownFutureValue. La valeur par défaut est active.

Prend en charge $filter (eq, ne) et $orderby.
tenantId String Identificateur global unique (GUID) du locataire pour lequel le moniteur s’exécute. Récupéré automatiquement par le système.

Prend en charge $filter (eq, ne).

Relations

Relation Type Description
Base configurationBaseline Relation qui contient les détails d’au moins une ressource et d’une propriété associée à la ressource à surveiller. Retourné uniquement avec $select. Prend en charge $expand.

Représentation JSON

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

{
  "@odata.type": "#microsoft.graph.configurationMonitor",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "inactivationReason": "String",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "mode": "String",
  "monitorRunFrequencyInHours": "Int32",
  "parameters": {"@odata.type": "microsoft.graph.openComplexDictionaryType"},
  "status": "String",
  "tenantId": "String"
}