Workspace Purge - Purge

  • Riferimento
Servizio:
Log Analytics
Versione API:
2023-09-01

Elimina i dati in un'area di lavoro Log Analytics da un set di filtri definiti dall'utente.

Per gestire le risorse di sistema, le richieste di ripulitura sono limitate a 50 all'ora. È consigliabile effettuare l'esecuzione in batch delle richieste di ripulitura inviando un unico comando il cui predicato includa tutte le identità utente che richiedono ripulitura. Usare l'operatore in per specificare più identità. È necessario eseguire la query prima di usare per una richiesta di eliminazione per verificare che i risultati siano previsti. Log Analytics supporta solo le operazioni di eliminazione necessarie per la conformità al GDPR. Il team del prodotto Log Analytics si riserva il diritto di rifiutare le richieste di operazioni di eliminazione che non sono ai fini della conformità al GDPR. In caso di controversia, creare un ticket di supporto

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
subscriptionId
 path True

string

ID della sottoscrizione di destinazione.
workspaceName
 path True

string

Nome dell'area di lavoro.

Criterio di espressione regolare: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
filters True

WorkspacePurgeBodyFilters[]

Set di colonne e filtri (query) da eseguire per ripulire i dati risultanti.
table True

string

Tabella da cui eliminare i dati.

Risposte

Nome Tipo Descrizione
202 Accepted

WorkspacePurgeResponse

Richiesta accettata per l'eliminazione di un'area di lavoro Log Analytics.

Intestazioni

x-ms-status-location: string

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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"
}

Definizioni

Nome Descrizione
WorkspacePurgeBody

Descrive il corpo di una richiesta di eliminazione per un'area di lavoro di App Insights
WorkspacePurgeBodyFilters

Filtri definiti dall'utente per restituire i dati che verranno eliminati dalla tabella.
WorkspacePurgeResponse

Risposta contenente operationId per un'azione di eliminazione specifica.

WorkspacePurgeBody

Descrive il corpo di una richiesta di eliminazione per un'area di lavoro di App Insights

Nome Tipo Descrizione
filters

WorkspacePurgeBodyFilters[]

Set di colonne e filtri (query) da eseguire per ripulire i dati risultanti.
table

string

Tabella da cui eliminare i dati.

WorkspacePurgeBodyFilters

Filtri definiti dall'utente per restituire i dati che verranno eliminati dalla tabella.

Nome Tipo Descrizione
column

string

Colonna della tabella su cui deve essere eseguita la query specificata
key

string

Quando si filtrano dimensioni personalizzate, questa chiave verrà utilizzata come nome della dimensione personalizzata.
operator

string

Operatore di query da valutare sulla colonna e sui valori specificati. Gli operatori supportati sono ==, =~, in, in~, >, >=, <<= , tra e hanno lo stesso comportamento di una query KQL.
value

valore per l'operatore su cui funzionare. Può trattarsi di un numero (ad esempio, > 100), una stringa (timestamp >= '2017-09-01') o una matrice di valori.

WorkspacePurgeResponse

Risposta contenente operationId per un'azione di eliminazione specifica.

Nome Tipo Descrizione
operationId

string

ID da utilizzare durante l'esecuzione di query sullo stato per una determinata operazione di eliminazione.