Freigeben über

sensitivityLabel: computeInheritance

Namespace: microsoft.graph

Berechnen Sie die Vertraulichkeitsbezeichnung, die von einem Ausgabeartefakt geerbt werden soll, wenn ein Satz von Vertraulichkeitsbezeichnungen aus Eingabe- oder Referenzartefakten vorhanden ist.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) SensitivityLabel.Evaluate.All SensitivityLabel.Evaluate
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application SensitivityLabel.Evaluate.All SensitivityLabel.Evaluate

HTTP-Anforderung

GET /security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance

Filterparameter

Parameter Typ Beschreibung
applicableTo Zeichenfolge Optional. Eine durch Trennzeichen getrennte Zeichenfolge von Inhaltsformaten (z. B file, email. ). Filtert die zurückgegebenen Bezeichnungen nur auf diejenigen, die für mindestens eines der angegebenen Formate gelten. Mögliche Werte sind email, file, schematizedData, site, teamwork, . unifiedGroup
Gebietsschema String Optional. Gibt das Gebietsschema für lokalisierbare Felder an.
labelIds Auflistung von Zeichenfolgen Optional. Eine Auflistung von durch Trennzeichen getrennten Zeichenfolgen von Vertraulichkeitsbezeichnungs-GUIDs. Filtert die zurückgegebenen Bezeichnungen nur auf diejenigen, die den angegebenen IDs entsprechen.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.
Client-Request-ID Optional. Eine vom Client generierte GUID zum Nachverfolgen der Anforderung. Empfohlen für die Problembehandlung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein einzelnes sensitivityLabel-Objekt im Antworttext zurück, das die berechnete geerbte Bezeichnung darstellt.

Wenn basierend auf der Eingabe und den Filtern keine entsprechende Bezeichnung gefunden wird oder ein Fehler auftritt (z. B. eine ungültige Bezeichnungs-ID angegeben), gibt die API möglicherweise eine Fehlerantwort (z. B 400 Bad Request . oder 404 Not Found) mit Details in einem Fehlerobjekt zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Berechnen der geerbten Bezeichnung aus der Eingabebezeichnung, wobei nur Bezeichnungen berücksichtigt werden, die auf das File Inhaltsformat anwendbar sind.

GET https://graph.microsoft.com/v1.0/security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance(labelIds=["4e4234dd-377b-42a3-935b-0e42f138fa23"],locale='en-US',contentFormats=["File"])
Authorization: Bearer {token}
Content-Type: application/json
Client-Request-Id: c5e4d3b2-a1f0-e9d8-c7b6-a5e4d3b2a1f0

"4e4234dd-377b-42a3-935b-0e42f138fa23"  // General (Sensitivity 10, File/Email)

Antwort

Das folgende Beispiel zeigt die Antwort. Die vertrauliche Bezeichnung wird zurückgegeben, da sie die empfindlichste Bezeichnung unter den Eingaben ist, die das File Inhaltsformat unterstützt.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.security.sensitivityLabel",
  "id": "a7a21bba-8197-491f-a5d6-0d0f955397cf",
  "name": "Confidential",
  "description": "Confidential data.",
  "color": "#ff0000",
  "priority": 0,
  "toolTip": "Data that requires protection.",
  "isEnabled": true,
  "isEndpointProtectionEnabled": true,
  "autoTooltip": "",
  "actionSource": "manual",
  "applicableTo": "email,teamwork,file",
  "sublabels": []
}
  • Last updated on