Feedback Bearbeiten

informationProtectionLabel: evaluateClassificationResults

  • Artikel
  • 6 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Berechnen Sie mithilfe von Klassifizierungsergebnissen die Informationsschutzbezeichnung , die angewendet werden soll, und geben Sie den Satz von Aktionen zurück, die ausgeführt werden müssen, um die Informationen korrekt zu bezeichnen. Diese API ist nützlich, wenn eine Bezeichnung automatisch basierend auf der Klassifizierung des Dateiinhalts festgelegt werden sollte, anstatt direkt von einem Benutzer oder Dienst bezeichnet zu werden.

Um basierend auf Klassifizierungsergebnissen auszuwerten, stellen Sie "contentInfo" bereit, das vorhandene Schlüssel-Wert-Paare für Inhaltsmetadaten und Klassifizierungsergebnisse enthält. Die API gibt eine informationProtectionAction zurück, die eine der folgenden Elemente enthält:

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) InformationProtectionPolicy.Read
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung InformationProtectionPolicy.Read.All

HTTP-Anforderung

POST /informationProtection/policy/labels/{id}/evaluateClassificationResults

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.
Content-type application/json. Erforderlich.
User-Agent Beschreibt den Namen und die Version der aufrufenden Anwendung. Details werden in Azure Information Protection Analytics angezeigt. Das vorgeschlagene Format lautet "ApplicationName/Version". Optional.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter Typ Beschreibung
Contentinfo Contentinfo Stellt Details zum Inhaltsformat, zum Inhaltsstatus und zu vorhandenen Metadaten als Schlüssel-Wert-Paare bereit.
classificationResults classificationResult-Auflistung Enthält den Satz von Klassifizierungsergebnissen, die vom Datenklassifizierungsendpunkt zurückgegeben werden. Klassifizierungsinformationen werden verwendet, um die entsprechende Bezeichnung basierend auf der Microsoft Purview Information Protection-Richtlinienbezeichnungskonfiguration im Office 365 Security and Compliance Center zu ermitteln.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein neues InformationProtectionAction-Auflistungsobjekt im Antworttext zurückgegeben.

Beispiele

Das folgende Beispiel illustriert, wie Sie diese API aufrufen können.

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/informationProtection/policy/labels/evaluateClassificationResults
Content-type: application/json
User-agent: ContosoLOBApp/1.0

{
  "contentInfo": {
    "@odata.type": "#microsoft.graph.contentInfo",
    "format@odata.type": "#microsoft.graph.contentFormat",
    "format": "default",
    "identifier": null,
    "state@odata.type": "#microsoft.graph.contentState",
    "state": "rest"
  },
  "classificationResults": [
    {
      "sensitiveTypeId": "cb353f78-2b72-4c3c-8827-92ebe4f69fdf",
      "count": 4,
      "confidenceLevel": 75
    }
  ]
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.informationProtectionAction)",
  "value": [
    {
      "@odata.type": "#microsoft.graph.applyLabelAction",
      "responsibleSensitiveTypeIds": [
        "cb353f78-2b72-4c3c-8827-92ebe4f69fdf"
      ],
      "actionSource": "automatic",
      "label": {
        "id": "722a5300-ac39-4c9a-88e3-f54c46676417",
        "name": "Top Secret",
        "description": "",
        "color": "#000000",
        "sensitivity": 13,
        "tooltip": "This information is Top Secret.",
        "isActive": true
      },
      "actions": [
        {
          "@odata.type": "#microsoft.graph.protectByTemplateAction",
          "templateId": "0e7fea72-7bba-4438-a070-95c292cd6f8c"
        },
        {
          "@odata.type": "#microsoft.graph.metadataAction",
          "metadataToRemove": [],
          "metadataToAdd": [
            {
              "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Enabled",
              "value": "true"
            },
            {
              "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SetDate",
              "value": "2019-10-03T21:50:20Z"
            },
            {
              "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Method",
              "value": "Standard"
            },
            {
              "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_Name",
              "value": "Top Secret"
            },
            {
              "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_SiteId",
              "value": "cb46c030-1825-4e81-a295-151c039dbf02"
            },
            {
              "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ActionId",
              "value": "76dc494e-6c59-43e6-88a1-0000edd58fca"
            },
            {
              "name": "MSIP_Label_722a5300-ac39-4c9a-88e3-f54c46676417_ContentBits",
              "value": "8"
            }
          ]
        }
      ]
    }
  ]
}