ブック オブジェクトの一覧表示

名前空間: microsoft.graph.security

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

テナントで ブック を取得します。

応答では、既定では 内容 は省略されます。 コレクション応答でブック ドキュメントを取得するには、コンテンツ ($select=id,name,content など) を明示的に選択します。

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

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

アクセス許可

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

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

Workbooks API を使用するには、テナントがアクティブでオンボードされている必要があります。 委任された職場または学校とアプリケーションのアクセス許可には、管理者の同意が必要です。 委任アクセスでは、サインイン ユーザーが該当する Microsoft Defender XDR 統合 RBAC 承認を持っている必要もあります。 個人用の Microsoft アカウントはサポートされていません。

HTTP 要求

GET /security/workbooks

オプションのクエリ パラメーター

このメソッドでは、返すプロパティを選択するための $select OData クエリ パラメーターがサポートされています。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

応答に @odata.nextLinkが含まれている場合は、次のページを取得するために、変更されていない完全な URL を要求します。 応答に @odata.nextLink が含まれなくなるまで続行します。 URL 内のスキップ トークンは不透明なものとして扱います。これをデコードしたり、自分でトークンを作成したりしないでください。

要求ヘッダー

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

要求本文

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

応答

成功した場合、このメソッドは応答本文で 200 OK 応答コードと microsoft.graph.security.workbook オブジェクトのコレクションを返します。

例

例 1: ブックのメタデータを一覧表示する

要求

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

GET https://graph.microsoft.com/beta/security/workbooks

応答

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

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.workbook",
      "id": "ba989c62-af63-b8de-286d-7474ec579357",
      "name": "Threat hunting overview",
      "createdByUpn": "adelev@contoso.com",
      "lastUpdatedByUpn": "adelev@contoso.com",
      "createdAtDateTime": "2026-09-22T10:00:00Z",
      "updatedAtDateTime": "2026-09-22T10:00:00Z"
    }
  ]
}

例 2: ブックのコンテンツを含める

要求

次の例では、ブック ID、名前、および完全なコンテンツ ドキュメントを選択します。

GET https://graph.microsoft.com/beta/security/workbooks?$select=id,name,content

応答

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.security.workbook",
      "id": "ba989c62-af63-b8de-286d-7474ec579357",
      "name": "Threat hunting overview",
      "content": {
        "version": "1.0",
        "title": "Threat hunting overview",
        "items": [
          {
            "type": "text",
            "text": "Investigate recent security activity."
          }
        ],
        "settings": {
          "showTitle": true
        }
      }
    }
  ]
}
  • 最終更新: