driveItem: extractSensitivityLabels

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.

Extraiga una o varias etiquetas de confidencialidad asignadas a un elemento de unidad y actualice los metadatos de un elemento de unidad con los detalles más recientes de la etiqueta asignada. Si no se pueden extraer las etiquetas de confidencialidad de un archivo, se genera un error de extracción con el código de error y el mensaje aplicables.

Para obtener más información sobre las etiquetas de confidencialidad desde la perspectiva de un administrador, vea Habilitar etiquetas de confidencialidad para archivos de Office en SharePoint y OneDrive.

Nota:

Esta API solo es aplicable a las extensiones de archivo admitidas. Cuando se llama, esta API recupera primero los metadatos de la etiqueta de confidencialidad del archivo de la base de datos y, a continuación, comprueba si los detalles de la etiqueta de confidencialidad son los más recientes en términos de contenido del archivo. Si es así, se devuelven los valores recuperados de la base de datos. Si no, las etiquetas de confidencialidad se extraen del flujo de contenido del archivo, los metadatos correspondientes se actualizan en la base de datos y se devuelven los valores recién extraídos.

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) Files.Read.All Files. ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Files.Read.All Files. ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Nota:

Esta API no es compatible con los contenedores de Microsoft SharePoint Embedded.

Solicitud HTTP

POST /drives/{drive-id}/items/{item-id}/extractSensitivityLabels
POST /drives/{drive-id}/root:/{item-path}:/extractSensitivityLabels
POST /groups/{group-id}/drive/items/{item-id}/extractSensitivityLabels
POST /groups/{group-id}/drive/root:/{item-path}:/extractSensitivityLabels
POST /me/drive/items/{item-id}/extractSensitivityLabels
POST /me/drive/root:/{item-path}:/extractSensitivityLabels
POST /sites/{site-id}/drive/items/{item-id}/extractSensitivityLabels
POST /sites/{site-id}/drive/root:/{item-path}:/extractSensitivityLabels
POST /users/{user-id}/drive/items/{item-id}/extractSensitivityLabels
POST /users/{user-id}/drive/root:/{item-path}:/extractSensitivityLabels

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.

Cuerpo de la solicitud

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

Respuesta

Si se realiza correctamente, esta acción devuelve un 200 OK código de respuesta y un objeto extractSensitivityLabelsResult en el cuerpo de la respuesta.

Además de los errores generales que se aplican a Microsoft Graph, esta API devuelve el código de 423 Locked respuesta, que indica que el archivo al que se accede está bloqueado. En estos casos, la propiedad code del objeto response indica el tipo de error que bloquea la extracción de la etiqueta de confidencialidad. A continuación se muestran los valores posibles para los tipos de error.

Valor Descripción
fileDoubleKeyEncrypted Indica que el archivo está protegido mediante el cifrado de doble clave; por lo tanto, no se puede abrir para la extracción de las etiquetas de confidencialidad.
fileDecryptionNotSupported Indica que SharePoint no puede abrir el archivo cifrado para extraer etiquetas de confidencialidad debido a propiedades específicas del archivo.
fileDecryptionDeferred Indica que el archivo se está procesando para su descifrado; por lo tanto, no se puede abrir para la extracción de las etiquetas de confidencialidad.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/drive/root/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/extractSensitivityLabels

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": {
    "@odata.type": "microsoft.graph.extractSensitivityLabelsResult",
    "labels": [
      {
        "sensitivityLabelId": "5feba255-812e-446a-ac59-a7044ef827b5",
        "assignmentMethod": "standard",
        "tenantId": "fed495cb-8c27-41ea-8749-00b0a084bc3d"
      },
      {
        "sensitivityLabelId": "fa781fdf-68c8-43ec-ae08-c4813deb2144",
        "assignmentMethod": "standard",
        "tenantId": "277601b1-6094-456c-a358-95bfc99539d7"
      },
      {
        "sensitivityLabelId": "3937098d-df0c-4c8d-8f66-5876b57b75ba",
        "assignmentMethod": "standard",
        "tenantId": "f2477f30-c8a2-422d-8995-6f056b494655"
      }
    ]
  }
}
  • Last updated on