Regel aktualisierenUpdate rule

Namespace: microsoft.graphNamespace: microsoft.graph

Ändern Sie die schreibbaren Eigenschaften in einem messageRule-Objekt, und speichern Sie die Änderungen.Change writable properties on a messageRule object and save the changes.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
AnwendungApplication MailboxSettings.ReadWriteMailboxSettings.ReadWrite

HTTP-AnforderungHTTP request

PATCH /me/mailFolders/inbox/messageRules/{id}
PATCH /users/{id | userPrincipalName}/mailFolders/inbox/messageRules/{id}

Optionale AnforderungsheaderOptional request headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
Aktionenactions messageRuleActionsmessageRuleActions Aktionen, die auf eine Nachricht angewendet werden, wenn die entsprechenden Bedingungen erfüllt sind.Actions to be taken on a message when the corresponding conditions are fulfilled.
Bedingungenconditions messageRulePredicatesmessageRulePredicates Bedingungen, die bei Erfüllung die entsprechenden Aktionen für diese Regel auslösen.Conditions that when fulfilled, will trigger the corresponding actions for that rule.
displayNamedisplayName StringString Der Anzeigename der Regel.The display name of the rule.
Ausnahmenexceptions messageRulePredicatesmessageRulePredicates Ausnahmebedingungen für die Regel.Exception conditions for the rule.
isEnabledisEnabled Boolescher WertBoolean Gibt an, ob die Regel auf Nachrichten angewendet werden kann.Indicates whether the rule is enabled to be applied to messages.
isReadOnlyisReadOnly Boolescher WertBoolean Gibt an, ob die Regel schreibgeschützt ist und von der Regel-REST-API nicht geändert oder gelöscht werden kann.Indicates if the rule is read-only and cannot be modified or deleted by the rules REST API.
sequencesequence Int32Int32 Gibt die Reihenfolge an, in der die Regel zusammen mit anderen Regeln ausgeführt wird.Indicates the order in which the rule is executed, among other rules.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das aktualisierte messageRule-Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and updated messageRule object in the response body.

BeispielExample

AnforderungRequest

Im folgenden Beispiel werden der Name der Regel sowie die Aktionen, die für diese Regel ausgeführt werden sollen, im Beispiel in Regel abrufen von der Weiterleitung an eine Adresse zur Markierung ihrer Wichtigkeit in „Hoch“ geändert.The following example changes the name of the rule, and the actions to be taken for that rule in the example in Get rule, from forwarding to an address to marking its importance as high.

PATCH https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messageRules/AQAAAJ5dZqA=
Content-type: application/json

{
    "displayName": "Important from partner",
    "actions": {
        "markImportance": "high"
     }
} 
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Me/mailFolders('inbox')/messageRules/$entity",
  "id":"AQAAAJ5dZqA=",
  "displayName":"Important from partner",
  "sequence":2,
  "isEnabled":true,
  "hasError":false,
  "isReadOnly":false,
  "conditions":{
    "senderContains":[
      "ADELE"
    ]
  },
  "actions":{
    "markImportance": "high"
  }
}