driveItem: extractSensitivityLabels

  • Artículo

Espacio de nombres: microsoft.graph

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 se produce un error al extraer las etiquetas de confidencialidad de un archivo, se produce un error de extracción con el código y el mensaje de error 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 se aplica a las extensiones de archivo admitidas. Cuando se le llama, esta API recupera primero los metadatos de 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 de archivo. Si es así, se devuelven los valores recuperados de la base de datos. Si no es así, 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 nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

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

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 la autenticación y la autorización.

Cuerpo de la solicitud

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

Respuesta

Si se ejecuta 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 423 Locked código de respuesta, lo que indica que el archivo al que se accede está bloqueado. En tales casos, la propiedad de código del objeto de respuesta indica el tipo de error que bloquea la extracción de etiquetas 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 el archivo cifrado tiene propiedades específicas que no permiten que SharePoint abra estos archivos para extraer etiquetas de confidencialidad.
fileDecryptionDeferred Indica que el archivo se está procesando para el descifrado; por lo tanto, no se puede abrir para la extracción de las etiquetas de confidencialidad.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/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"
      }
    ]
  }
}