Dela via

Workspace Purge - Purge

  • Referens
Tjänst:
Log Analytics
API-version:
2025-02-01

Rensar data på en Log Analytics-arbetsyta med en uppsättning användardefinierade filter.

För att hantera systemresurser begränsas rensningsbegäranden till 50 begäranden per timme. Du bör batcha körningen av rensningsbegäranden genom att skicka ett enda kommando vars predikat innehåller alla användaridentiteter som kräver rensning. Använd in-operatorn för att ange flera identiteter. Du bör köra frågan innan du använder för en rensningsbegäran för att verifiera att resultatet förväntas. Log Analytics stöder endast rensningsåtgärder som krävs för kompatibilitet med GDPR. Log Analytics-produktteamet förbehåller sig rätten att avvisa begäranden om rensningsåtgärder som inte är avsedda för GDPR-efterlevnad. I händelse av en tvist skapar du ett supportärende

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId
 path True

string

minLength: 1

ID för målprenumerationen.
workspaceName
 path True

string

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

Namnet på arbetsytan.
api-version
 query True

string

minLength: 1

DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name Obligatorisk Typ Description
filters True

WorkspacePurgeBodyFilters[]

Den uppsättning kolumner och filter (frågor) som ska köras över dem för att rensa resulterande data.
table True

string

Tabell som data ska rensas från.

Svar

Name Typ Description
202 Accepted

WorkspacePurgeResponse

Godkänd begäran om rensning av en Log Analytics-arbetsyta.

Sidhuvuden

x-ms-status-location: string

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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"
}

Definitioner

Name Description
WorkspacePurgeBody

Beskriver brödtexten i en rensningsbegäran för en App Insights-arbetsyta
WorkspacePurgeBodyFilters

Användardefinierade filter för att returnera data som kommer att rensas från tabellen.
WorkspacePurgeResponse

Svar som innehåller operationId för en specifik rensningsåtgärd.

WorkspacePurgeBody

Objekt

Beskriver brödtexten i en rensningsbegäran för en App Insights-arbetsyta

Name Typ Description
filters

WorkspacePurgeBodyFilters[]

Den uppsättning kolumner och filter (frågor) som ska köras över dem för att rensa resulterande data.
table

string

Tabell som data ska rensas från.

WorkspacePurgeBodyFilters

Objekt

Användardefinierade filter för att returnera data som kommer att rensas från tabellen.

Name Typ Description
column

string

Kolumnen i tabellen som den angivna frågan ska köras över
key

string

När du filtrerar över anpassade dimensioner används den här nyckeln som namnet på den anpassade dimensionen.
operator

string

En frågeoperator som ska utvärderas över den angivna kolumnen och de angivna värdena. Operatorerna som stöds är ==, =~, i, i~, >, >=, <, <=, mellan och har samma beteende som i en KQL-fråga.
value

värdet som operatorn ska fungera över. Det kan vara ett tal (t.ex. > 100), en sträng (tidsstämpel >= '2017-09-01') eller matris med värden.

WorkspacePurgeResponse

Objekt

Svar som innehåller operationId för en specifik rensningsåtgärd.

Name Typ Description
operationId

string

ID som ska användas när du frågar efter status för en viss rensningsåtgärd.