Condividi tramite

Workspace Purge - Purge

  • Riferimento
Servizio:
Log Analytics
Versione API:
2025-02-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 eliminazione vengono limitate a 50 richieste all'ora. È consigliabile inviare in batch l'esecuzione delle richieste di eliminazione inviando un singolo comando il cui predicato include tutte le identità utente che richiedono l'eliminazione. Usare l'operatore in per specificare più identità. È consigliabile eseguire la query prima di usare per una richiesta di ripulitura 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 eliminazione delle operazioni 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=2025-02-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId
 path True

string

minLength: 1

ID della sottoscrizione di destinazione.
workspaceName
 path True

string

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

Nome dell'area di lavoro.
api-version
 query True

string

minLength: 1

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=2025-02-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=2025-02-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=2025-02-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=2025-02-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Definizioni

Nome Descrizione
WorkspacePurgeBody

Descrive il corpo di una richiesta di ripulitura 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

Object

Descrive il corpo di una richiesta di ripulitura 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

Object

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 le 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~, >, >=, <, <=, between e hanno lo stesso comportamento di una query KQL.
value

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

WorkspacePurgeResponse

Object

Risposta contenente operationId per un'azione di eliminazione specifica.

Nome Tipo Descrizione
operationId

string

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