messageRule-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Eine Regel, die auf Nachrichten im Posteingang eines Benutzers angewendet wird.

In Outlook können Sie Regeln für eingehende Nachrichten im Posteingang festlegen, um bestimmte Aktionen bei bestimmten Bedingungen auszuführen.

Programmgesteuert können Sie über die messageRules-Navigationseigenschaft des Posteingangsordners auf Regeln zugreifen. Jede Regel wird von dieser messageRule-Ressource dargestellt, verfügbare Regelaktionen werden von dem komplexen Typ messageRuleActions dargestellt, und verfügbare Regelbedingungen und -ausnahmen werden von dem komplexen Typ messageRulePredicates dargestellt.

Methoden

Methode	Rückgabetyp	Beschreibung
Auflisten von Regeln	messageRule-Sammlung	Ruft alle messageRule-Objekte ab, die für das Postfach des Benutzers definiert sind.
Regel abrufen	messageRule	Lesen der Eigenschaften und Beziehungen eines messageRule-Objekts.
Erstellen	messageRule	Erstellen Sie ein messageRule-Objekt, indem Sie eine Gruppe von Bedingungen und Aktionen angeben.
Update	messageRule	Ändern Sie die schreibbaren Eigenschaften in einem messageRule-Objekt, und speichern Sie die Änderungen.
Löschen	Keine	Löschen des angegebenen messageRule-Objekts.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Aktionen	messageRuleActions	Aktionen, die auf eine Nachricht angewendet werden, wenn die entsprechenden Bedingungen erfüllt sind.
Bedingungen	messageRulePredicates	Bedingungen, die bei Erfüllung die entsprechenden Aktionen für diese Regel auslösen.
displayName	String	Der Anzeigename der Regel.
Ausnahmen	messageRulePredicates	Ausnahmebedingungen für die Regel.
hasError	Boolescher Wert	Gibt an, ob sich die Regel in einem Fehlerzustand befindet. Schreibgeschützt.
id	String	Der eindeutige Bezeichner der Regel. Schreibgeschützt.
isEnabled	Boolescher Wert	Gibt an, ob die Regel auf Nachrichten angewendet werden kann.
isReadOnly	Boolescher Wert	Gibt an, ob die Regel schreibgeschützt ist und von der Regel-REST-API nicht geändert oder gelöscht werden kann.
sequence	Int32	Gibt die Reihenfolge an, in der die Regel zusammen mit anderen Regeln ausgeführt wird.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "actions": {"@odata.type": "microsoft.graph.messageRuleActions"},
  "conditions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
  "displayName": "String",
  "exceptions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
  "hasError": "Boolean",
  "id": "String",
  "isEnabled": "Boolean",
  "isReadOnly": "Boolean",
  "sequence": "Int32"
}