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.

Métodos

Propiedades

Reglas de filtrado de API de etiqueta de confidencialidad

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

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

El usuario llama a la API y filtra uno o varios 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, or no se permite en los parámetros de filtro.

2. Comportamiento de prefiltrado con OR

   • Si or está presente en los parámetros de filtro, locale y contentFormats los parámetros de filtro (si están presentes) no se usarán para prefiltrar.

3. Excepción OR interna

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

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

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

Ejemplo

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

Rules

1. Restricción OR con varios parámetros

   • Si hay alguno de los parámetros de filtro siguientes: , ido ownerEmail, or no se permite en los parámetros de filtro. isScopedToUser

2. validación de ownerEmail

   • ownerEmail presente sin id produce un ArgumentExceptionobjeto .

3. Comportamiento de prefiltrado con OR

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

4. Excepción OR interna

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

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

El usuario quiere 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 estándar de OData. En OData estándar, normalmente no se admite la combinación de varias tuplas con or de esta manera. Sin embargo, esta API permite usar un patrón OR basado en tupla, donde 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 estándar de OData $filter , vea la especificación de OData.

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

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

Rules

1. Patrón OR estricto

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

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

2. validación de ownerEmail

   • ownerEmailsiempre debe aparecer junto con .id El uso ownerEmail solo de da como resultado un ArgumentException.

3. Excepción OR interna

   • Puede combinar cláusulas mediante subclauses. Este es un ejemplo de una subclause: (id eq 'guid1' y ownerEmail eq 'ownerEmail1')

   • En este ejemplo, hay tres subclauses. Al combinar el identificador y ownerEmail, use AND en la subclase. No use OR; de lo contrario, produce una excepción.

4. Comportamiento de prefiltro

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

Resumen de comportamiento

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

Rules

1. Restricción OR con ownerEmail

   • or las operaciones con el parámetro ownerEmail de filtro producen una excepción.

2. Excepción OR interna

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

Reglas de parámetro isScopedToUser

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

Comportamiento de los parámetros

isScopedToUser = true

• Resultado: solo muestra las etiquetas habilitadas
• Caso de uso: filtrado de Standard para etiquetas activas o habilitadas
• Estado: uso recomendado

isScopedToUser = false

• Resultado: solo muestra las etiquetas deshabilitadas
• Caso de uso: limitado: idealmente no se usa con este valor
• Estado: no se recomienda para operaciones típicas

isScopedToUser 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, se producirá el uso isScopedToUser de ArgumentException
• Motivo: El parámetro no es aplicable para las operaciones de etiqueta de nivel de inquilino
• Solución: omita 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",
  "id": "String (identifier)",
  "name": "String",
  "displayName": "String",
  "description": "String",
  "toolTip": "String",
  "isEnabled": "Boolean",
  "isEndpointProtectionEnabled": "Boolean",
  "isDefault": "Boolean",
  "applicationMode": "String",
  "priority": "Integer",
  "applicableTo": "String",
  "color": "String",
  "autoTooltip": "String",
  "locale": "String",
  "isScopedToUser": "Boolean",
  "actionSource": "String"
}