Freigeben über

Components - Purge

  • Referenz
Dienst:
Application Insights
API-Version:
2015-05-01

Löscht Daten in einer Application Insights-Komponente durch einen Satz benutzerdefinierter Filter.

Um Systemressourcen zu verwalten, werden Löschanforderungen bei 50 Anforderungen pro Stunde gedrosselt. Sie sollten die Ausführung von Bereinigungsanforderungen stapeln, indem Sie einen einzelnen Befehl senden, dessen Prädikat alle Benutzeridentitäten enthält, die Löschvorgang erfordern. Verwenden Sie den In-Operator, um mehrere Identitäten anzugeben. Sie sollten die Abfrage vor der Verwendung einer 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

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
resourceName
 path True

string

Der Name der Application Insights-Komponentenressource.
subscriptionId
 path True

string

minLength: 1

Die ID des Zielabonnements.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
filters True

ComponentPurgeBodyFilters[]

Der Satz von Spalten und Filtern (Abfragen), die über diese ausgeführt werden sollen, um die resultierenden Daten zu löschen.
table True

string

Tabelle, aus der Daten gelöscht werden sollen.

Antworten

Name Typ Beschreibung
202 Accepted

ComponentPurgeResponse

Akzeptierte Anforderung zum Löschen einer Application Insights-Komponente.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

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

Statuscode:
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
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Definitionen

Name Beschreibung
ComponentPurgeBody

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

Benutzerdefinierte Filter, um Daten zurückzugeben, die aus der Tabelle gelöscht werden.
ComponentPurgeResponse

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

ComponentPurgeBody

Objekt

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

Name Typ Beschreibung
filters

ComponentPurgeBodyFilters[]

Der Satz von Spalten und Filtern (Abfragen), die über diese ausgeführt werden sollen, um die resultierenden Daten zu löschen.
table

string

Tabelle, aus der Daten gelöscht werden sollen.

ComponentPurgeBodyFilters

Objekt

Benutzerdefinierte Filter, um Daten zurückzugeben, 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 über benutzerdefinierte Dimensionen wird dieser Schlüssel als Name der benutzerdefinierten Dimension verwendet.
operator

string

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

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

ComponentPurgeResponse

Objekt

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

Name Typ Beschreibung
operationId

string

Id, die beim Abfragen des Status für einen bestimmten Bereinigungsvorgang verwendet werden soll.