Udostępnij za pośrednictwem

Workspace Purge - Purge

  • Odwołanie
Usługa:
Log Analytics
Wersja interfejsu API:
2023-09-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 do 50 żądań na godzinę. Wykonanie żądań przeczyszczania powinno być wsadowe przez wysłanie pojedynczego polecenia, 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. Należy uruchomić zapytanie przed użyciem dla żądania przeczyszczania, 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ą przeznaczone do celów zgodności z ROZPORZĄDZENIEM 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=2023-09-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
 path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
subscriptionId
 path True

string

Identyfikator subskrypcji docelowej.
workspaceName
 path True

string

Nazwa obszaru roboczego.

Wzorzec wyrażenia regularnego: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
filters True

WorkspacePurgeBodyFilters[]

Zestaw kolumn i filtrów (zapytań) do ich uruchamiania 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 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=2023-09-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=2023-09-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=2023-09-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=2023-09-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ą wyczyszczone z tabeli.
WorkspacePurgeResponse

Odpowiedź zawierająca identyfikator operationId konkretnej akcji przeczyszczania.

WorkspacePurgeBody

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

Nazwa Typ Opis
filters

WorkspacePurgeBodyFilters[]

Zestaw kolumn i filtrów (zapytań) do ich uruchamiania w celu przeczyszczenia wynikowych danych.
table

string

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

WorkspacePurgeBodyFilters

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

Nazwa Typ Opis
column

string

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

string

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

string

Operator zapytania, który ma być obliczany 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

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.