Получить analyzedEmail

Пространство имен: microsoft.graph.security

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Чтение свойств и связей объекта analyzedEmail .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальное обслуживание Правительство США L4 Правительство США L5 (DOD) Китай, обслуживаемый 21Vianet
✅ ❌ ❌ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшим объемом привилегий Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись) Не поддерживается. Не поддерживается.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение SecurityAnalyzedMessage.Read.All SecurityAnalyzedMessage.ReadWrite.All

HTTP-запрос

GET /security/collaboration/analyzedEmails/{analyzedEmailId}

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успеха этот метод возвращает код ответа 200 OK и объект microsoft.graph.security.analyzedEmail в тексте ответа.

Примеры

Пример 1. Получение analyzedEmail

Запрос

GET https://graph.microsoft.com/beta/security/collaboration/analyzedEmails/{analyzedEmailId}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "value": {
    "@odata.type": "#microsoft.graph.security.analyzedEmail",
    "id": "String",
    "loggedDateTime": "Datetime",
    "networkMessageId": "String",
    "internetMessageId": "String",
    "senderDetail": {
      "@odata.type": "microsoft.graph.security.analyzedEmailSenderDetail"
    },
    "recipientEmailAddress": "String",
    "distributionList": "String",
    "subject": "String",
    "returnPath": "String",
    "directionality": "microsoft.graph.security.antispamDirectionality",
    "originalDelivery": {
      "@odata.type": "microsoft.graph.security.analyzedEmailDeliveryDetail"
    },
    "latestDelivery": {
      "@odata.type": "microsoft.graph.security.analyzedEmailDeliveryDetail"
    },
    "attachments": [
      {
        "@odata.type": "microsoft.graph.security.analyzedEmailAttachment"
      }
    ],
    "urls": [
      {
        "@odata.type": "microsoft.graph.security.analyzedEmailUrl"
      }
    ],
    "language": "String",
    "sizeInBytes": "Integer",
    "alertIds": [
      "String"
    ],
    "exchangeTransportRules": [
      {
        "@odata.type": "microsoft.graph.security.analyzedEmailExchangeTransportRuleInfo"
      }
    ],
    "overrideSources": [
      "String"
    ],
    "threatTypes": [
      "microsoft.graph.security.threatType"
    ],
    "detectionMethods": [
      "String"
    ],
    "contexts": [
      "String"
    ],
    "authenticationDetails": {
      "@odata.type": "microsoft.graph.security.analyzedEmailAuthenticationDetail"
    },
    "phishConfidenceLevel": "String",
    "spamConfidenceLevel": "String",
    "bulkComplaintLevel": "String",
    "emailClusterId": "String",
    "policyAction": "String",
    "policy": "String",
    "timelineEvents": [
      {
        "@odata.type": "microsoft.graph.security.timelineEvent"
      }
    ],
    "threatDetectionDetails": [
      {
        "@odata.type": "microsoft.graph.security.threatDetectionDetail"
      }
    ],
    "primaryOverrideSource": "String",
    "inboundConnectorFormattedName": "String",
    "policyType": "String",
    "clientType": "String",
    "dlpRules": [
      {
        "@odata.type": "microsoft.graph.security.analyzedEmailDlpRuleInfo"
      }
    ],
    "forwardingDetail": "String",
    "recipientDetail": {
      "@odata.type": "microsoft.graph.security.analyzedEmailRecipientDetail"
    }
  }
}

Пример 2. Получение URL-адресов из analyzedEmail

Запрос

GET https://graph.microsoft.com/beta/security/collaboration/analyzedEmails/{analyzedEmailId}/Urls

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.analyzedEmailUrl",
      "url": "String",
      "threatType": "String",
      "detectionMethod": "String",
      "tenantAllowBlockListDetailInfo": "String",
      "detonationDetails": {
        "@odata.type": "microsoft.graph.security.detonationDetails"
      }
    }
  ]
}

Пример 3. Получение вложений analyzedEmail

Запрос

GET https://graph.microsoft.com/beta/security/collaboration/analyzedEmails/{analyzedEmailId}/attachments

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.analyzedEmailAttachment",
      "fileName": "String",
      "fileType": "String",
      "fileSize": "Integer",
      "fileExtension": "String",
      "threatType": "String",
      "malwareFamily": "String",
      "tenantAllowBlockListDetailInfo": "String",
      "sha256": "String",
      "detonationDetails": {
        "@odata.type": "microsoft.graph.security.detonationDetails"
      }
    }
  ]
}
  • Last updated on