Tipo de recurso messageRulemessageRule resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Regla que se aplica a los mensajes de la Bandeja de entrada de un usuario.A rule that applies to messages in the Inbox of a user.

En Outlook, puede establecer reglas de los mensajes entrantes en la Bandeja de entrada para llevar a cabo acciones específicas en determinadas condiciones.In Outlook, you can set up rules for incoming messages in the Inbox to carry out specific actions upon certain conditions.

Mediante programación, tiene acceso a las reglas a través de la propiedad de navegación messageRules de la carpeta Bandeja de entrada.Programmatically, you can access rules through the messageRules navigation property of the Inbox folder. Cada regla se representa mediante este recurso messageRule, las acciones de regla disponibles se representan mediante el tipo complejo messageRuleActions y las condiciones de regla disponibles se representan mediante el tipo complejo messageRulePredicates.Each rule is represented by this messageRule resource, available rule actions are represented by the messageRuleActions complex type, and available rule conditions and exceptions are represented by the messageRulePredicates complex type.

PropiedadesProperties

PropiedadProperty TipoType DescriptionDescription
actionsactions messageRuleActionsmessageRuleActions Acciones que se van a realizar en un mensaje cuando se cumplan las condiciones correspondientes.Actions to be taken on a message when the corresponding conditions are fulfilled.
conditionsconditions messageRulePredicatesmessageRulePredicates Condiciones que, cuando se cumplan, activarán las acciones correspondientes a esa regla.Conditions that when fulfilled, will trigger the corresponding actions for that rule.
displayNamedisplayName CadenaString Nombre para mostrar de la regla.The display name of the rule.
exceptionsexceptions messageRulePredicatesmessageRulePredicates Condiciones de excepción de la regla.Exception conditions for the rule.
hasErrorhasError BooleanBoolean Indica si la regla es una condición de error.Indicates whether the rule is in an error condition. Solo lectura.Read-only.
idid CadenaString Identificador único de la regla.The unique identifier of the rule. Solo lectura.Read-only.
isEnabledisEnabled BooleanBoolean Indica si la regla está habilitada para que se aplique a los mensajes.Indicates whether the rule is enabled to be applied to messages.
isReadOnlyisReadOnly BooleanBoolean Indica si la regla es de solo lectura y la API de REST de reglas no la puede modificar ni eliminar.Indicates if the rule is read-only and cannot be modified or deleted by the rules REST API.
sequencesequence Int32Int32 Indica el orden en que se ejecuta la regla entre otras reglas.Indicates the order in which the rule is executed, among other rules.

Representación JSONJSON representation

Aquí tiene una representación JSON del recurso.Here is a JSON representation of the resource.

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

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescriptionDescription
Enumerar reglasList rules Colección messageRulemessageRule collection Obtener todos los objetos messageRule definidos para la Bandeja de entrada del usuario.Get all the messageRule objects defined for the user's Inbox.
Obtener reglaGet rule messageRulemessageRule Leer las propiedades y relaciones de un objeto messageRule.Read the properties and relationships of a messageRule object.
CrearCreate messageRulemessageRule Crear un objeto messageRule especificando un conjunto de condiciones y acciones.Create a messageRule object by specifying a set of conditions and actions.
ActualizarUpdate messageRulemessageRule Cambie las propiedades modificables en un objeto messageRule y guarde los cambios.Change writable properties on a messageRule object and save the changes.
EliminarDelete NingunoNone Eliminar el objeto messageRule especificado.Delete the specified messageRule object.