sensitivityLabel: computeInheritance

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Calcular la etiqueta de confidencialidad que debe heredar un artefacto de salida, dado un conjunto de etiquetas de confidencialidad de los artefactos de entrada o a los que se hace referencia.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) SensitivityLabel.Evaluate SensitivityLabel.Evaluate.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación SensitivityLabel.Evaluate SensitivityLabel.Evaluate.All

Solicitud HTTP

GET /security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance

Filtrar parámetros

Parámetro Tipo Descripción
aplicableA Cadena Opcional. Una cadena de formatos de contenido separados por comas (por ejemplo, File,Email). Filtra las etiquetas devueltas a solo aquellas aplicables al menos a uno de los formatos especificados. Los valores posibles son Email,File,SchematizedData,Site,Teamwork,UnifiedGroup.
configuración regional String Opcional. Especifica la configuración regional de los campos localizables.
labelIds Colección de cadenas Opcional. Una colección de cadenas separadas por comas de GUID de etiquetas de confidencialidad. Filtra las etiquetas devueltas a solo aquellas que coinciden con los identificadores especificados.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.
client-request-id Opcional. Un GUID generado por el cliente para realizar un seguimiento de la solicitud. Recomendado para solucionar problemas.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se realiza correctamente, este método devuelve un 200 OK código de respuesta y un único objeto sensitivityLabel en el cuerpo de la respuesta, que representa la etiqueta heredada calculada.

Si no se encuentra ninguna etiqueta aplicable en función de la entrada y los filtros, o si se produce un error (por ejemplo, se proporcionó un identificador de etiqueta no válido), la API podría devolver una respuesta de error (por ejemplo, 400 Bad Request o 404 Not Found) con detalles en un objeto de error.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra una solicitud para calcular la etiqueta heredada a partir de la etiqueta de entrada, teniendo en cuenta solo las etiquetas aplicables al formato de File contenido.

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)

Respuesta

En el ejemplo siguiente se muestra la respuesta. La etiqueta confidencial se devuelve porque es la etiqueta más confidencial entre las entradas que admite el formato de File contenido.

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": []
}
  • Se actualizó por última vez el