Compartir a través de

sensitivityLabel: computeInheritance

Espacio de nombres: microsoft.graph

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

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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.All SensitivityLabel.Evaluate
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación SensitivityLabel.Evaluate.All SensitivityLabel.Evaluate

Solicitud HTTP

GET /security/dataSecurityAndGovernance/sensitivityLabels/computeInheritance

Parámetros de filtro

Parámetro Tipo Descripción
applicableTo Cadena Opcional. Cadena separada por comas de formatos de contenido (por ejemplo, file, email). Filtra las etiquetas devueltas solo a las aplicables a al menos uno de los formatos especificados. Los valores posibles son , , , , , unifiedGroupteamwork. siteschematizedDatafileemail
configuración regional String Opcional. Especifica la configuración regional de los campos localizables.
labelIds Colección de cadenas Opcional. Colección de GUID de etiquetas de confidencialidad separados por comas. Filtra las etiquetas devueltas solo a aquellas que coinciden con los identificadores especificados.

Encabezados de solicitud

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

Cuerpo de la solicitud

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

Respuesta

Si se ejecuta 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 basada en la entrada y los filtros, o si se produce un error (por ejemplo, se proporciona 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 de la etiqueta de entrada, teniendo en cuenta solo las etiquetas aplicables al formato de File contenido.

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)

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/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