Arbeitsmappe aktualisieren

Namespace: microsoft.graph.security

Erstellen oder Ersetzen einer Arbeitsmappe mit einer vom Client ausgewählten ID.

Geben Sie eine GUID in der Anforderungs-URL ein. Ohne bedingten Header erstellt diese Methode die Arbeitsmappe, wenn diese ID nicht vorhanden ist, oder ersetzt ihren Namen und Inhalt, wenn sie vorhanden ist. Die Wiederverwendung derselben GUID behält die Identität der Arbeitsmappe bei. Updates behalten createdByUpn und createdAtDateTime bei.

Der Inhaltswert ersetzt das vollständige JSON-Dokument. Es handelt sich nicht um eine Teilaktualisierung oder eine verschachtelte Zusammenführung.

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

PATCH /security/workbooks/{workbookId}

Anforderungsheader

Für If-Matchkopieren Sie den Wert aus dem HTTP-Antwortheader ETag der Arbeitsmappe unverändert, einschließlich des W/ Präfixes und der Anführungszeichen. Übereinstimmende starke und schwache Darstellungen des aktuellen ETag werden akzeptiert. Behandeln Sie ETags als undurchsichtige Werte; generieren Sie sie nicht selbst.

Anforderungstext

Geben Sie sowohl den Namen als auch den Inhalt im Anforderungstext an. Fügen Sie das vollständige Inhaltsdokument bei; Geschachtelte Eigenschaften, die Sie auslassen, werden aus der vorherigen Version nicht beibehalten.

Geben Sie im Anforderungstext keine id, etag, createdByUpn, lastUpdatedByUpn, createdAtDateTime oder updatedAtDateTime an. Die URL bestimmt die ID; Der Dienst verwaltet die Parallelitäts- und Überwachungseigenschaften.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode ein microsoft.graph.security.workbook-Objekt im Antworttext und einen der folgenden Antwortcodes zurück:

• 201 Created wenn die Arbeitsmappe erstellt wird. Die Location Kopfzeile enthält die Microsoft Graph-URL der Arbeitsmappe.
• 200 OK wenn eine vorhandene Arbeitsmappe ersetzt wird.

Der ETag Antwortheader enthält das aktuelle Parallelitätstoken der Arbeitsmappe.

Fehler

Die Methode wird zurückgegeben 412 Precondition Failed , wenn eine der folgenden Bedingungen zutrifft:

• Sie geben an If-None-Match: *, aber die Arbeitsmappe ist bereits vorhanden.
• Sie stellen an If-Match, aber die Arbeitsmappe ist nicht vorhanden oder das angegebene ETag entspricht nicht der aktuellen Version.

Beispiele

Beispiel 1: Ersetzen einer Arbeitsmappe nur, wenn sie sich nicht geändert hat

Anforderung

Im folgenden Beispiel wird die von Get Workbook zurückgegebene Schwachstelle ETag verwendet. Das bereitgestellte Inhaltsobjekt ersetzt das vorherige Dokument.

PATCH https://graph.microsoft.com/beta/security/workbooks/ba989c62-af63-b8de-286d-7474ec579357
Content-Type: application/json
If-Match: W/"0x8DE000000000001"

{
  "name": "Threat hunting overview - updated",
  "content": {
    "version": "2.0",
    "title": "Priority investigations",
    "items": [
      {
        "type": "text",
        "text": "Review the highest-priority investigations first."
      }
    ]
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort. Die Überwachungseigenschaften ID und Erstellung werden beibehalten, während die Updateüberwachungseigenschaften und ETag die neue Version widerspiegeln. Die vorherige content.settings-Eigenschaft wird nicht beibehalten, da sie im Ersatzdokument nicht angegeben wurde.

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

HTTP/1.1 200 OK
Content-Type: application/json
ETag: W/"0x8DE000000000002"

{
  "@odata.type": "#microsoft.graph.security.workbook",
  "id": "ba989c62-af63-b8de-286d-7474ec579357",
  "name": "Threat hunting overview - updated",
  "content": {
    "version": "2.0",
    "title": "Priority investigations",
    "items": [
      {
        "type": "text",
        "text": "Review the highest-priority investigations first."
      }
    ]
  },
  "createdByUpn": "adelev@contoso.com",
  "lastUpdatedByUpn": "alexw@contoso.com",
  "createdAtDateTime": "2026-09-22T10:00:00Z",
  "updatedAtDateTime": "2026-09-22T10:15:00Z"
}

Beispiel 2: Arbeitsmappe nur erstellen, wenn ihre ID nicht vorhanden ist

Anforderung

In diesem unabhängigen Beispiel wird davon ausgegangen, dass die Arbeitsmappen-ID nicht vorhanden ist. Der If-None-Match: * Header verhindert, dass die Anforderung eine Arbeitsmappe ersetzt, die diese ID bereits verwendet.

PATCH https://graph.microsoft.com/beta/security/workbooks/ba989c62-af63-b8de-286d-7474ec579357
Content-Type: application/json
If-None-Match: *

{
  "name": "Threat hunting overview",
  "content": {
    "version": "1.0",
    "title": "Threat hunting overview",
    "items": [
      {
        "type": "text",
        "text": "Investigate recent security activity."
      }
    ],
    "settings": {
      "showTitle": true
    }
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort, wenn die ID nicht vorhanden war. Das Wiederholen dieser Nur-Erstellen-Anforderung, nachdem die Arbeitsmappe vorhanden ist, gibt zurück 412 Precondition Failed.

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

HTTP/1.1 201 Created
Content-Type: application/json
Location: https://graph.microsoft.com/beta/security/workbooks/ba989c62-af63-b8de-286d-7474ec579357
ETag: W/"0x8DE000000000001"

{
  "@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
    }
  },
  "createdByUpn": "adelev@contoso.com",
  "lastUpdatedByUpn": "adelev@contoso.com",
  "createdAtDateTime": "2026-09-22T10:00:00Z",
  "updatedAtDateTime": "2026-09-22T10:00:00Z"
}