sensitivityLabel: computeInheritance

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Berechnen Sie die Vertraulichkeitsbezeichnung, die von einem Ausgabeartefakt geerbt werden soll, wenn ein Satz von Vertraulichkeitsbezeichnungen von Eingabe- oder referenzierten Artefakten gegeben ist.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ❌

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 SensitivityLabel.Evaluate.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application SensitivityLabel.Evaluate SensitivityLabel.Evaluate.All

HTTP-Anforderung

GET /security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance

Parameter filtern

Parameter Typ Beschreibung
applicable To Zeichenfolge Optional. Eine durch Trennzeichen getrennte Zeichenfolge von Inhaltsformaten (z. File,EmailB. ). Filtert die zurückgegebenen Etiketten nach denen, die auf mindestens eines der angegebenen Formate anwendbar sind. Mögliche Werte sind Email,File,SchematizedData,Site,,Teamwork.UnifiedGroup
Gebietsschema String Optional. Gibt das Gebietsschema für lokalisierbare Felder an.
labelIds Sammlung von Zeichenfolgen Optional. Eine Auflistung der durch Trennzeichen getrennten Zeichenfolgen von GUIDs für Vertraulichkeitsbezeichnungen. Gefiltert die zurückgegebenen Bezeichnungen nur nach denjenigen, die mit den angegebenen IDs übereinstimmen.

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 diese 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 anwendbare Bezeichnung gefunden wird oder wenn ein Fehler auftritt (z. B. eine ungültige Bezeichnungs-ID), 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 von der Eingabebezeichnung, wobei nur Bezeichnungen berücksichtigt werden, die für das File Inhaltsformat gelten.

GET https://graph.microsoft.com/beta/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 Vertraulichkeitsbezeichnung wird zurückgegeben, da sie die sensibelste 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/beta/$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,
  "hasProtection": true,
  "autoTooltip": "",
  "actionSource": "manual",
  "applicableTo": "email,teamwork,file",
  "sublabels": []
}
  • Zuletzt aktualisiert um