次の方法で共有

driveItem: extractSensitivityLabels

  • [アーティクル]

名前空間: microsoft.graph

ドライブ項目に割り当てられた 1 つ以上の秘密度ラベルを抽出し、割り当てられたラベルの最新の詳細でドライブ項目のメタデータを更新します。 ファイルの秘密度ラベルを抽出できない場合は、該当するエラー コードとメッセージを含む抽出エラーがスローされます。

管理者の観点からの秘密度ラベルの詳細については、「 SharePoint および OneDrive で Office ファイルの秘密度ラベルを有効にする」を参照してください。

注: この API は、サポートされているファイル拡張子にのみ適用されます。 呼び出されると、この API は最初にファイルの秘密度ラベルメタデータをデータベースから取得し、次にファイルコンテンツの観点から秘密度ラベルの詳細が最新であるかどうかを確認します。 はいの場合、データベースから取得した値が返されます。 いいえの場合、ファイルのコンテンツ ストリームから秘密度ラベルが抽出され、対応するメタデータがデータベースで更新され、新しく抽出された値が返されます。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Files.Read.All Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Files.Read.All Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All

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

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このアクションは 200 OK 応答コードと、応答本文の extractSensitivityLabelsResult オブジェクトを返します。

Microsoft Graph に適用される一般的なエラーに加えて、この API は応答コードを 423 Locked 返します。これは、アクセスされているファイルがロックされていることを示します。 このような場合、応答オブジェクトの コード プロパティは、秘密度ラベルの抽出をブロックするエラーの種類を示します。 エラーの種類に使用できる値を次に示します。

値 説明
fileDoubleKeyEncrypted ファイルが二重キー暗号化によって保護されていることを示します。そのため、秘密度ラベルの抽出のために開くできません。
fileDecryptionNotSupported 暗号化されたファイルに、これらのファイルを SharePoint で開いて秘密度ラベルを抽出できない特定のプロパティがあることを示します。
fileDecryptionDeferred 暗号化解除のためにファイルが処理されていることを示します。そのため、秘密度ラベルの抽出のために開くできません。
unknownFutureValue 進化可能な列挙センチネル値。 使用しないでください。

例

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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