Delen via

Workspace Purge - Purge

  • Referentie
Service:
Log Analytics
API-versie:
2025-02-01

Hiermee verwijdert u gegevens in een Log Analytics-werkruimte door een set door de gebruiker gedefinieerde filters.

Om systeembronnen te beheren, worden opschoningsaanvragen beperkt tot 50 aanvragen per uur. U moet de uitvoering van opschoningsaanvragen in batches verwerken door één opdracht te verzenden waarvan het predicaat alle gebruikersidentiteiten bevat waarvoor opschoning is vereist. Gebruik de operator in om meerdere identiteiten op te geven. U moet de query uitvoeren voordat u een opschoningsaanvraag gebruikt om te controleren of de resultaten worden verwacht. Log Analytics biedt alleen ondersteuning voor opschoningsbewerkingen die vereist zijn voor naleving van de AVG. Het Log Analytics-productteam behoudt zich het recht voor aanvragen voor opschoningsbewerkingen af te wijzen die niet zijn bedoeld voor AVG-naleving. In het geval van een geschil maakt u een ondersteuningsticket

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId
 path True

string

minLength: 1

De id van het doelabonnement.
workspaceName
 path True

string

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

De naam van de werkruimte.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
filters True

WorkspacePurgeBodyFilters[]

De set kolommen en filters (query's) om ze uit te voeren om de resulterende gegevens op te ruimen.
table True

string

Tabel waaruit u gegevens wilt opschonen.

Antwoorden

Name Type Description
202 Accepted

WorkspacePurgeResponse

Geaccepteerde aanvraag voor het opschonen van een Log Analytics-werkruimte.

Kopteksten

x-ms-status-location: string

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
WorkspacePurgeBody

Beschrijft de hoofdtekst van een opschoningsaanvraag voor een App Insights-werkruimte
WorkspacePurgeBodyFilters

Door de gebruiker gedefinieerde filters om gegevens te retourneren die uit de tabel worden verwijderd.
WorkspacePurgeResponse

Antwoord met operationId voor een specifieke opschoningsactie.

WorkspacePurgeBody

Object

Beschrijft de hoofdtekst van een opschoningsaanvraag voor een App Insights-werkruimte

Name Type Description
filters

WorkspacePurgeBodyFilters[]

De set kolommen en filters (query's) om ze uit te voeren om de resulterende gegevens op te ruimen.
table

string

Tabel waaruit u gegevens wilt opschonen.

WorkspacePurgeBodyFilters

Object

Door de gebruiker gedefinieerde filters om gegevens te retourneren die uit de tabel worden verwijderd.

Name Type Description
column

string

De kolom van de tabel waarop de opgegeven query moet worden uitgevoerd
key

string

Wanneer u filtert op aangepaste dimensies, wordt deze sleutel gebruikt als de naam van de aangepaste dimensie.
operator

string

Een queryoperator die moet worden geëvalueerd via de opgegeven kolom en waarde(s). Ondersteunde operators zijn ==, =~, in, in~, >, >=, <, <=, tussen en hebben hetzelfde gedrag als in een KQL-query.
value

de waarde voor de operator die moet worden uitgevoerd. Dit kan een getal zijn (bijvoorbeeld > 100), een tekenreeks (tijdstempel >= '2017-09-01') of een matrix met waarden.

WorkspacePurgeResponse

Object

Antwoord met operationId voor een specifieke opschoningsactie.

Name Type Description
operationId

string

Id die moet worden gebruikt bij het uitvoeren van query's op status voor een bepaalde opschoningsbewerking.