Auflisten von Arbeitsmappenobjekten

Namespace: microsoft.graph.security

Rufen Sie die Arbeitsmappen im Mandanten ab.

Die Antwort lässt standardmäßig Inhalte aus. Um Arbeitsmappendokumente in der Sammlungsantwort abzurufen, wählen Sie explizit Inhalt aus, $select=id,name,contentz. B.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Der Mandant muss aktiv und integriert sein, um die Arbeitsmappen-APIs verwenden zu können. Für die delegierten Geschäfts-, Schul- oder Uniberechtigungen und Anwendungsberechtigungen ist die Zustimmung des Administrators erforderlich. Der delegierte Zugriff erfordert auch, dass der angemeldete Benutzer über die entsprechende Microsoft Defender XDR Unified RBAC-Autorisierung verfügt. Persönliche Microsoft-Konten werden nicht unterstützt.

HTTP-Anforderung

GET /security/workbooks

Optionale Abfrageparameter

Diese Methode unterstützt den $select OData-Abfrageparameter, um die Eigenschaften auszuwählen, die zurückgegeben werden sollen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Wenn eine Antwort enthält @odata.nextLink, fordern Sie diese vollständige URL unverändert an, um die nächste Seite abzurufen. Fahren Sie fort, bis die Antwort nicht mehr enthält @odata.nextLink. Behandeln Sie das Skip-Token in der URL als undurchsichtig. Dekodieren Sie es nicht und konstruieren Sie selbst kein Token.

Anforderungsheader

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und eine Auflistung der microsoft.graph.security.workbook-Objekte im Antworttext zurück.

Beispiele

Beispiel 1: Auflisten von Arbeitsmappenmetadaten

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

Beispiel 2: Arbeitsmappeninhalt einbeziehen

Anforderung

Im folgenden Beispiel werden die Arbeitsmappen-ID, der Name und das vollständige Inhaltsdokument ausgewählt.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

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