Udostępnij za pośrednictwem

Workspace Purge - Purge

  • Odwołanie
Usługa:
Log Analytics
Wersja interfejsu API:
2025-02-01

Przeczyszcza dane w obszarze roboczym usługi Log Analytics za pomocą zestawu filtrów zdefiniowanych przez użytkownika.

Aby zarządzać zasobami systemowymi, żądania przeczyszczania są ograniczane o 50 żądań na godzinę. Wykonywanie żądań przeczyszczania należy wykonać wsadowe, wysyłając jedno polecenie, którego predykat zawiera wszystkie tożsamości użytkowników, które wymagają przeczyszczania. Użyj operatora in, aby określić wiele tożsamości. Przed użyciem żądania przeczyszczania należy uruchomić zapytanie, aby sprawdzić, czy wyniki są oczekiwane. Usługa Log Analytics obsługuje tylko operacje przeczyszczania wymagane do zapewnienia zgodności z RODO. Zespół produktu usługi Log Analytics zastrzega sobie prawo do odrzucania żądań dotyczących operacji przeczyszczania, które nie są zgodne z RODO. W przypadku sporu utwórz bilet pomocy technicznej

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId
 path True

string

minLength: 1

Identyfikator subskrypcji docelowej.
workspaceName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Nazwa obszaru roboczego.
api-version
 query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
filters True

WorkspacePurgeBodyFilters[]

Zestaw kolumn i filtrów (zapytań), które mają być uruchamiane w celu przeczyszczenia wynikowych danych.
table True

string

Tabela, z której mają być czyszkane dane.

Odpowiedzi

Nazwa Typ Opis
202 Accepted

WorkspacePurgeResponse

Zaakceptowano żądanie przeczyszczania obszaru roboczego usługi Log Analytics.

Nagłówki

x-ms-status-location: string

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:
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=2025-02-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

WorkspacePurgeResourceId

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:
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=2025-02-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Definicje

Nazwa Opis
WorkspacePurgeBody

Opisuje treść żądania przeczyszczania dla obszaru roboczego usługi App Insights
WorkspacePurgeBodyFilters

Filtry zdefiniowane przez użytkownika w celu zwrócenia danych, które zostaną przeczyszczone z tabeli.
WorkspacePurgeResponse

Odpowiedź zawierająca identyfikator operationId konkretnej akcji przeczyszczania.

WorkspacePurgeBody

Objekt

Opisuje treść żądania przeczyszczania dla obszaru roboczego usługi App Insights

Nazwa Typ Opis
filters

WorkspacePurgeBodyFilters[]

Zestaw kolumn i filtrów (zapytań), które mają być uruchamiane w celu przeczyszczenia wynikowych danych.
table

string

Tabela, z której mają być czyszkane dane.

WorkspacePurgeBodyFilters

Objekt

Filtry zdefiniowane przez użytkownika w celu zwrócenia danych, które zostaną przeczyszczone z tabeli.

Nazwa Typ Opis
column

string

Kolumna tabeli, w której powinno zostać uruchomione dane zapytanie
key

string

Podczas filtrowania za pośrednictwem wymiarów niestandardowych ten klucz będzie używany jako nazwa wymiaru niestandardowego.
operator

string

Operator zapytania do oceny dla podanej kolumny i wartości. Obsługiwane operatory to ==, =~, in, in~, >, >=, <, <=, between i mają takie samo zachowanie jak w zapytaniu KQL.
value

wartość operatora do działania. Może to być liczba (np. > 100), ciąg (sygnatura czasowa >= "2017-09-01") lub tablica wartości.

WorkspacePurgeResponse

Objekt

Odpowiedź zawierająca identyfikator operationId konkretnej akcji przeczyszczania.

Nazwa Typ Opis
operationId

string

Identyfikator do użycia podczas wykonywania zapytań o stan określonej operacji przeczyszczania.