tipo de recurso sensitivityLabel

Espacio de nombres: microsoft.graph.security

Describe la etiqueta de protección de la información que detalla cómo aplicar correctamente una etiqueta de confidencialidad a la información. El recurso informationProtectionLabel describe la configuración de etiquetas de confidencialidad que se aplican a un usuario o inquilino.

Métodos

Propiedades

Reglas de filtrado de la API de etiquetas de confidencialidad

En esta sección se describen las restricciones y reglas de filtrado disponibles para aplicar a varias llamadas API de etiquetas de confidencialidad.

Escenario 1: Devolver etiquetas de confidencialidad (1 o más)

El usuario llama a la API y filtra por uno o más GUID de identificador de etiqueta.

Ejemplo

$filter=((id eq 'guid1') or (id eq 'guid2') or (id eq 'guid3'))

Rules

1. Restricción OR con isScopedToUser

   • Si isScopedToUser el parámetro de filtro está presente, entonces or no está permitido en los parámetros de filtro

2. Comportamiento de filtrado previo con OR

   • Si or está presente en los parámetros de filtro, entonces locale los parámetros de filtro ( contentFormats si están presentes) no se usarán para el filtrado previo

3. Excepción de OR interno

   • Se permiten las operaciones internas or que se encuentran en el árbol de parámetros

Escenario 2: Devolver resultados para etiquetas de confidencialidad mediante un filtro en un solo identificador y un solo derecho de usuario

El usuario llama a la API y filtra por un id. de etiqueta, GUID y un derecho de usuario.

Ejemplo

$filter=(id eq 'guid1' and ownerEmail eq 'ownerEmail1')

Rules

1. Restricción del quirófano con varios parámetros

   • Si está presente alguno de los siguientes parámetros de filtro: isScopedToUser, id, o ownerEmail, no or se permite en los parámetros de filtro

2. ownerValidación de correo electrónico

   • ownerEmail presente sin id lanza un ArgumentException.

3. Comportamiento de filtrado previo con OR

   • Si or está presente en la cadena de $filter, los parámetros de filtro then locale se contentFormats omiten y no se usan para prefiltrar los resultados.

4. Excepción de OR interno

   • Puedes usar operaciones internas or entre cláusulas individuales.

Escenario 2.5: Devolver resultados para etiquetas de confidencialidad usando un filtro para varios identificadores y derechos de usuario

El usuario desea llamar a la API y filtrar por varios identificadores y ownerEmail. Para lograr este resultado, debe combinar el identificador de etiqueta y ownerEmail en una cláusula booleana.

Ejemplo

$filter=(
   (id eq 'guid1' and ownerEmail eq 'ownerEmail1')
  or (id eq 'guid2')
  or (id eq 'guid3' and ownerEmail eq 'ownerEmail2')
)

Este $filter patrón es una extensión de la especificación OData estándar. En OData estándar, la combinación de varias tuplas con or de esta manera no suele ser compatible. Sin embargo, esta API permite usar un patrón OR basado en tuplas, en el que cada (id, ownerEmail) par se evalúa de forma independiente y se combina la información de derechos resultante. Para obtener más información sobre el comportamiento OData $filter estándar, consulte la especificación OData.

Se recomienda usar filtros que usen una sola llamada con varios identificadores para recuperar los derechos de varias etiquetas, ya que esto reduce el número de llamadas API que debe realizar desde la aplicación.

ownerEmail es opcional y solo se puede omitir para capturar derechos de nivel de etiqueta.

Rules

1. Patrón O estricto

   • Solo se admite la estructura basada en tupla combinada por operaciones OR como se muestra arriba.

   • No se permite ninguna otra combinación de operaciones OR o la combinación de filtros no relacionados y da como resultado una ArgumentException.

2. ownerValidación de correo electrónico

   • ownerEmail debe aparecer siempre junto con un id. Usar ownerEmail solo da como resultado un ArgumentExceptionarchivo .

3. Excepción de OR interno

   • Puedes combinar cláusulas usando subcláusulas. Este es un ejemplo de una subcláusula: (id eq 'guid1' y ownerEmail eq 'ownerEmail1')

   • En este ejemplo, hay tres subcláusulas. Al combinar el ID y ownerEmail, usa AND en la subcláusula. No use O, de lo contrario se produce una excepción.

4. Comportamiento de prefiltrado

   • Cuando or se usa, los parámetros and contentFormats (si se proporcionan) se omiten para el locale prefiltrado.

Resumen de comportamiento

Escenario 3: Derechos de etiqueta de confidencialidad /id/rights

Rules

1. O restricción con ownerEmail

   • or Las operaciones con el parámetro ownerEmail de filtro dan como resultado una excepción.

2. Excepción de OR interno

   • Se permiten las operaciones internas or que se encuentran en el árbol de parámetros.

Reglas del parámetro isScopedToUser

En esta sección se describen el comportamiento y las restricciones del parámetro en las isScopedToUser API de etiquetas de confidencialidad.

Comportamiento de parámetros

isScopedToUser = true

• Resultado: Solo muestra las etiquetas habilitadas
• Caso de uso: Filtrado Standard para etiquetas activas/habilitadas
• Estado: uso recomendado

isScopedToUser = false

• Resultado: Solo muestra las etiquetas deshabilitadas
• Caso de uso: Limitado; lo ideal es que no se use con este valor
• Estado: no recomendado para operaciones típicas

isScopeedToUser no pasado

• Resultado: Muestra todas las etiquetas (habilitadas y deshabilitadas)
• Caso de uso: Recuperación completa de etiquetas
• Estado: comportamiento predeterminado cuando se omite el parámetro

Restricciones

Excepción de etiquetas de inquilino

• Comportamiento: Al obtener etiquetas de inquilino, el uso isScopedToUser producirá ArgumentException
• Motivo: El parámetro no es aplicable a las operaciones de etiqueta de nivel de inquilino
• Solución: Omitir el isScopedToUser parámetro al trabajar con etiquetas de inquilino

Relaciones

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.security.sensitivityLabel",
  "actionSource": "String",
  "applicableTo": "String",
  "applicationMode": "String",
  "assignedPolicies": [{"@odata.type": "microsoft.graph.labelPolicy"}],
  "autoLabeling": {"@odata.type": "microsoft.graph.autoLabeling"},
  "autoTooltip": "String",
  "color": "String",
  "description": "String",
  "displayName": "String",
  "hasProtection": "Boolean",
  "id": "String (identifier)",
  "isDefault": "Boolean",
  "isEnabled": "Boolean",
  "isEndpointProtectionEnabled": "Boolean",
  "isScopedToUser": "Boolean",
  "labelActions": [{"@odata.type": "microsoft.graph.encryptWithUserDefinedRights"}],
  "locale": "String",
  "name": "String",
  "priority": "Int32",
  "toolTip": "String"
}