Delen via

Workspace Purge - Purge

  • Referentie
Service:
Log Analytics
API-versie:
2023-09-01

Hiermee worden gegevens in een Log Analytics-werkruimte verwijderd met behulp van een set door de gebruiker gedefinieerde filters.

Voor het beheren van systeemresources worden opschoningsaanvragen beperkt met 50 aanvragen per uur. U moet de uitvoering van opschoningsaanvragen in batches uitvoeren 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 voor een opschoningsaanvraag gebruikt om te controleren of de resultaten worden verwacht. Log Analytics ondersteunt alleen opschoonbewerkingen die vereist zijn voor naleving van de AVG. Het Log Analytics-productteam behoudt zich het recht voor om aanvragen voor opschoningsbewerkingen die niet voor avg-naleving zijn, af te wijzen. Maak in het geval van een geschil een ondersteuningsticket

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
 path True

string

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

string

De id van het doelabonnement.
workspaceName
 path True

string

De naam van de werkruimte.

Regex-patroon: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

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) die moet worden uitgevoerd om de resulterende gegevens op te ruimen.
table True

string

Tabel waaruit gegevens moeten worden verwijderd.

Antwoorden

Name Type Description
202 Accepted

WorkspacePurgeResponse

Aanvraag geaccepteerd 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=2023-09-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=2023-09-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=2023-09-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=2023-09-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 voor het retourneren van gegevens die uit de tabel worden verwijderd.
WorkspacePurgeResponse

Antwoord met operationId voor een specifieke opschoningsactie.

WorkspacePurgeBody

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

Name Type Description
filters

WorkspacePurgeBodyFilters[]

De set kolommen en filters (query's) die moet worden uitgevoerd om de resulterende gegevens op te ruimen.
table

string

Tabel waaruit gegevens moeten worden verwijderd.

WorkspacePurgeBodyFilters

Door de gebruiker gedefinieerde filters voor het retourneren van gegevens 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

Bij het filteren op aangepaste dimensies wordt deze sleutel gebruikt als de naam van de aangepaste dimensie.
operator

string

Een queryoperator om de opgegeven kolom en waarde(s) te evalueren. Ondersteunde operators zijn ==, =~, in, in~, >, >=, <, <=, tussen en hebben hetzelfde gedrag als in een KQL-query.
value

de waarde voor de operator om over te werken. Dit kan een getal zijn (bijvoorbeeld > 100), een tekenreeks (tijdstempel >= '2017-09-01') of een matrix met waarden.

WorkspacePurgeResponse

Antwoord met operationId voor een specifieke opschoningsactie.

Name Type Description
operationId

string

Id die moet worden gebruikt bij het opvragen van de status voor een bepaalde opschoningsbewerking.