Partilhar via


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, blockedSendersafeSender, , domainAllowListadvancedSpamFiltering, 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"
}