Components - Purge

Referenz

Service:: Application Insights

API Version:: 2015-05-01

Löscht Daten in einer Application Insights-Komponente 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.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/purge?api-version=2015-05-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.
resourceName	path	True	string	Der Name der Application Insights-Komponentenressource.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
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	ComponentPurgeBodyFilters[]	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	ComponentPurgeResponse	Akzeptierte Anforderung zum Bereinigen einer Application Insights-Komponente.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

ComponentPurge

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.Insights/components/aztest5048/purge?api-version=2015-05-01

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

Sample Response

Status code:: 202

x-ms-status-location: https://management.azure.com/subscriptions/b96161de-b34a-480f-7343-59b099299283/resourceGroups/example/providers/microsoft.insights/components/test/operations/purge-970318e7-b859-4edb-8903-83b1b54d0b74?api-version=2015-05-01

Response Body

{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Definitionen

Name	Beschreibung
ComponentPurgeBody	Beschreibt den Text einer Bereinigungsanforderung für eine App Insights-Komponente.
ComponentPurgeBodyFilters	Benutzerdefinierte Filter zum Zurückgeben von Daten, die aus der Tabelle gelöscht werden.
ComponentPurgeResponse	Antwort, die operationId für eine bestimmte Bereinigungsaktion enthält.

ComponentPurgeBody

Beschreibt den Text einer Bereinigungsanforderung für eine App Insights-Komponente.

Name	Typ	Beschreibung
filters	ComponentPurgeBodyFilters[]	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.

ComponentPurgeBodyFilters

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.

ComponentPurgeResponse

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.