Listar regrasList rules

Namespace: microsoft.graphNamespace: microsoft.graph

Obtenha todos os objetos messageRule definidos para a Caixa de Entrada do usuário.Get all the messageRule objects defined for the user's Inbox.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) MailboxSettings.ReadMailboxSettings.Read
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) MailboxSettings.ReadMailboxSettings.Read
AplicativoApplication MailboxSettings.ReadMailboxSettings.Read

Solicitação HTTPHTTP request

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

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the OData Query Parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

NomeName TipoType DescriçãoDescription
AutorizaçãoAuthorization stringstring {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará um código de resposta 200 OK e uma coleção de objetos messageRule no corpo da resposta.If successful, this method returns a 200 OK response code and collection of messageRule objects in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messageRules
RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.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",
  "value":[
    {
      "id":"AQAAAJ5dZp8=",
      "displayName":"Remove spam",
      "sequence":1,
      "isEnabled":true,
      "hasError":false,
      "isReadOnly":false,
      "conditions":{
        "subjectContains":[
          "enter to win"
        ]
      },
      "actions":{
        "delete":true,
        "stopProcessingRules":true
      }
    },
    {
      "id":"AQAAAJ5dZqA=",
      "displayName":"From partner",
      "sequence":2,
      "isEnabled":true,
      "hasError":false,
      "isReadOnly":false,
      "conditions":{
        "senderContains":[
          "ADELE"
        ]
      },
      "actions":{
        "stopProcessingRules":true,
        "forwardTo":[
          {
            "emailAddress":{
              "name":"Alex Wilbur",
              "address":"AlexW@contoso.onmicrosoft.com"
            }
          }
        ]
      }
    }
  ]
}