Freigeben über

Workspace Purge - Purge

  • Referenz
Dienst:
Log Analytics
API-Version:
2023-09-01

Löscht Daten in einem Log Analytics-Arbeitsbereich durch einen Satz benutzerdefinierter Filter.

Zur Verwaltung von Systemressourcen werden Bereinigungsanforderungen auf 50 Anforderungen pro Stunde gedrosselt. Sie sollten die Ausführung von Bereinigungsanforderungen in Batches einbinden, indem Sie einen einzelnen Befehl senden, dessen Prädikat alle Benutzeridentitäten enthält, die bereinigt werden müssen. Verwenden Sie den in-Operator, um mehrere Identitäten anzugeben. Sie sollten die Abfrage vor der Verwendung für eine Bereinigungsanforderung ausführen, um zu überprüfen, ob die Ergebnisse erwartet werden. Log Analytics unterstützt nur Löschvorgänge, die für die Einhaltung der DSGVO erforderlich sind. Das Log Analytics-Produktteam behält sich das Recht vor, Anträge auf Löschvorgänge, die nicht der EINHALTUNG DER DSGVO dienen, abzulehnen. Erstellen Sie im Falle einer Streitigkeit bitte ein Supportticket.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/purge?api-version=2023-09-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
 path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string

Hierbei handelt es sich um die ID des Zielabonnements.
workspaceName
 path True

string

Den Namen des Arbeitsbereichs

RegEx-Muster: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
filters True

WorkspacePurgeBodyFilters[]

Der Satz von Spalten und Filtern (Abfragen), um sie auszuführen, um die resultierenden Daten zu bereinigen.
table True

string

Tabelle, aus der Daten gelöscht werden sollen.

Antworten

Name Typ Beschreibung
202 Accepted

WorkspacePurgeResponse

Akzeptierte Anforderung zum Bereinigen eines Log Analytics-Arbeitsbereichs.

Header

x-ms-status-location: string

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Beispielanforderung

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.OperationalInsights/workspaces/aztest5048/purge?api-version=2023-09-01

{
  "table": "Heartbeat",
  "filters": [
    {
      "column": "TimeGenerated",
      "operator": ">",
      "value": "2017-09-01T00:00:00"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:
202 
x-ms-status-location: https://management.azure.com/subscriptions/b96161de-b34a-480f-7343-59b099299283/resourceGroups/example/providers/microsoft.operationalinsights/workspaces/test/operations/purge-970318e7-b859-4edb-8903-83b1b54d0b74?api-version=2023-09-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

WorkspacePurgeResourceId

Beispielanforderung

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.OperationalInsights/workspaces/aztest5048/purge?api-version=2023-09-01

{
  "table": "Heartbeat",
  "filters": [
    {
      "column": "_ResourceId",
      "operator": "==",
      "value": "/subscriptions/12341234-1234-1234-1234-123412341234/resourceGroups/SomeResourceGroup/providers/microsoft.insights/components/AppInsightResource"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:
202 
x-ms-status-location: https://management.azure.com/subscriptions/b96161de-b34a-480f-7343-59b099299283/resourceGroups/example/providers/microsoft.operationalinsights/workspaces/test/operations/purge-970318e7-b859-4edb-8903-83b1b54d0b74?api-version=2023-09-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Definitionen

Name Beschreibung
WorkspacePurgeBody

Beschreibt den Text einer Bereinigungsanforderung für einen App Insights-Arbeitsbereich.
WorkspacePurgeBodyFilters

Benutzerdefinierte Filter zum Zurückgeben von Daten, die aus der Tabelle gelöscht werden.
WorkspacePurgeResponse

Antwort, die operationId für eine bestimmte Bereinigungsaktion enthält.

WorkspacePurgeBody

Beschreibt den Text einer Bereinigungsanforderung für einen App Insights-Arbeitsbereich.

Name Typ Beschreibung
filters

WorkspacePurgeBodyFilters[]

Der Satz von Spalten und Filtern (Abfragen), um sie auszuführen, um die resultierenden Daten zu bereinigen.
table

string

Tabelle, aus der Daten gelöscht werden sollen.

WorkspacePurgeBodyFilters

Benutzerdefinierte Filter zum Zurückgeben von Daten, die aus der Tabelle gelöscht werden.

Name Typ Beschreibung
column

string

Die Spalte der Tabelle, über die die angegebene Abfrage ausgeführt werden soll
key

string

Beim Filtern nach benutzerdefinierten Dimensionen wird dieser Schlüssel als Name der benutzerdefinierten Dimension verwendet.
operator

string

Ein Abfrageoperator, der für die bereitgestellte Spalte und die angegebenen Werte ausgewertet werden soll. Unterstützte Operatoren sind ==, =~, in, in~, >, = >, <, = <, zwischen und haben das gleiche Verhalten wie in einer KQL-Abfrage.
value

der Wert für den Operator, der ausgeführt werden soll. Dies kann eine Zahl (z. B. > 100), eine Zeichenfolge (Zeitstempel >= '2017-09-01') oder ein Array von Werten sein.

WorkspacePurgeResponse

Antwort, die operationId für eine bestimmte Bereinigungsaktion enthält.

Name Typ Beschreibung
operationId

string

Id, die beim Abfragen nach status für einen bestimmten Bereinigungsvorgang verwendet werden soll.