messageRule-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Regel dar, die für Nachrichten im Posteingang eines Benutzers gilt.

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.
Delete	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	Zeichenfolge	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	Zeichenfolge	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

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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