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. |
| Regel erstellen | messageRule | Erstellen Sie ein messageRule-Objekt, indem Sie eine Gruppe von Bedingungen und Aktionen angeben. |
| Regel aktualisieren | messageRule | Ändern Sie die schreibbaren Eigenschaften in einem messageRule-Objekt, und speichern Sie die Änderungen. |
| Regel 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 | 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"
}