driveItem : extractSensitivityLabels

Espace de noms: microsoft.graph

Extrayez une ou plusieurs étiquettes de confidentialité affectées à un élément de lecteur et mettez à jour les métadonnées d’un élément de lecteur avec les derniers détails de l’étiquette affectée. En cas d’échec de l’extraction des étiquettes de confidentialité d’un fichier, une erreur d’extraction est générée avec le code d’erreur et le message applicables.

Pour plus d’informations sur les étiquettes de confidentialité du point de vue d’un administrateur, voir Activer les étiquettes de confidentialité pour les fichiers Office dans SharePoint et OneDrive.

Remarque : Cette API s’applique uniquement aux extensions de fichier prises en charge. Lorsqu’elle est appelée, cette API récupère d’abord les métadonnées d’étiquette de confidentialité du fichier à partir de la base de données, puis vérifie si les détails de l’étiquette de confidentialité sont les plus récents en termes de contenu du fichier. Si oui, les valeurs récupérées de la base de données sont retournées. Si non, les étiquettes de confidentialité sont extraites du flux de contenu du fichier, les métadonnées correspondantes sont mises à jour dans la base de données et les valeurs nouvellement extraites sont retournées.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Requête 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

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette action renvoie un 200 OK code de réponse et un objet extractSensitivityLabelsResult dans le corps de la réponse.

En plus des erreurs générales qui s’appliquent à Microsoft Graph, cette API retourne le 423 Locked code de réponse, qui indique que le fichier accessible est verrouillé. Dans ce cas, la propriété de code de l’objet response indique le type d’erreur qui bloque l’extraction de l’étiquette de confidentialité. Voici les valeurs possibles pour les types d’erreur.

Valeur Description
fileDoubleKeyEncrypted Indique que le fichier est protégé par le chiffrement à double clé ; par conséquent, il ne peut pas être ouvert pour l’extraction des étiquettes de confidentialité.
fileDecryptionNotSupported Indique que le fichier chiffré a des propriétés spécifiques qui n’autorisent pas l’ouverture de ces fichiers par SharePoint pour extraire les étiquettes de confidentialité.
fileDecryptionDeferred Indique que le fichier est en cours de traitement pour le déchiffrement ; par conséquent, il ne peut pas être ouvert pour l’extraction des étiquettes de confidentialité.
unknownFutureValue Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Exemples

Demande

L’exemple suivant illustre une demande.

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

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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"
      }
    ]
  }
}