driveItem: extractSensitivityLabels

[アーティクル]
10/30/2023

名前空間: 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	進化可能な列挙センチネル値。使用しないでください。

例

要求

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

HTTP
JavaScript

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


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/drive/root/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/extractSensitivityLabels')
	.post();

プロジェクトに SDK を追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

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

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

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