mailAssessmentRequest resource type (Tipo de recurso mailAssessmentRequest)
Utilizado para criar e obter uma avaliação de ameaças de correio, derivada de threatAssessmentRequest.
Quando cria um pedido de avaliação de ameaças de correio, o e-mail deve ser recebido pelo utilizador especificado em recipientEmail
. As permissões de Correio Delegado (Mail.Read ou Mail.Read.Shared) são necessárias para aceder ao e-mail recebido pelo utilizador ou partilhado por outra pessoa.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Criar | mailAssessmentRequest | Create um novo pedido de avaliação de correio ao publicar um objeto mailAssessmentRequest. |
Get | mailAssessmentRequest | Leia as propriedades e relações de um objeto mailAssessmentRequest . |
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
category | threatCategory | A categoria de ameaça. Os valores possíveis são: spam , phishing , malware . |
contentType | threatAssessmentContentType | O tipo de conteúdo da avaliação de ameaças. Os valores possíveis são: mail , url , file . |
createdBy | identitySet | O criador do pedido de avaliação de ameaças. |
createdDateTime | DateTimeOffset | O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . |
destinationRoutingReason | mailDestinationRoutingReason | O motivo pelo qual o correio foi encaminhado para o destino. Os valores possíveis são: none , , mailFlowRule , blockedSender safeSender , , domainAllowList advancedSpamFiltering , domainBlockList , notInAddressBook , firstTimeSender , autoPurgeToInbox , , autoPurgeToJunk , autoPurgeToDeleted , , outbound , , notJunk , . junk |
expectedAssessment | threatExpectedAssessment | A avaliação esperada do submetidor. Os valores possíveis são: block e unblock . |
id | Cadeia de caracteres | O ID do pedido de avaliação de ameaças é um identificador exclusivo global (GUID). |
messageUri | Cadeia de caracteres | O URI do recurso da mensagem de correio para avaliação. |
destinatárioEmail | Cadeia de caracteres | O destinatário de correio cujas políticas são utilizadas para avaliar o correio. |
requestSource | threatAssessmentRequestSource | A origem do pedido de avaliação de ameaças. Os valores possíveis são: administrator . |
status | threatAssessmentStatus | O processo de avaliação status. Os valores possíveis são: pending e completed . |
Relações
Relação | Tipo | Descrição |
---|---|---|
resultados | threatAssessmentResult collection (coleção threatAssessmentResult ) | Uma coleção de resultados da avaliação de ameaças. Somente leitura. Por predefinição, a GET /threatAssessmentRequests/{id} não devolve esta propriedade, a menos que a aplique $expand . |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"destinationRoutingReason": "String",
"messageUri": "String",
"recipientEmail": "String",
"category": "String",
"contentType": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"expectedAssessment": "String",
"id": "String (identifier)",
"requestSource": "String",
"status": "String"
}