Freigeben über


Components - Purge

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.

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

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

ComponentPurge

Beispielanforderung

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

Beispiel für eine Antwort

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
{
  "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.