Sdílet prostřednictvím

Workspace Purge - Purge

  • Reference
Služba:
Log Analytics
Verze rozhraní API:
2023-09-01

Vyprázdní data v pracovním prostoru služby Log Analytics pomocí sady uživatelsky definovaných filtrů.

Kvůli správě systémových prostředků se žádosti o vymazání omezují na 50 požadavků za hodinu. Spuštění požadavků na vyprázdnění byste měli dávkovat odesláním jednoho příkazu, jehož predikát zahrnuje všechny identity uživatelů, které vyžadují vymazání. Operátor in slouží k určení více identit. Před použitím požadavku na vyprázdnění byste měli spustit dotaz, abyste ověřili, že se výsledky očekávají. Log Analytics podporuje pouze operace mazání vyžadované pro dodržování gdpr. Produktový tým Log Analytics si vyhrazuje právo odmítnout žádosti o operace vymazání, které nejsou určené pro účely dodržování nařízení GDPR. V případě sporu vytvořte lístek podpory.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId
 path True

string

minLength: 1

ID cílového předplatného.
workspaceName
 path True

string

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

Název pracovního prostoru.
api-version
 query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Vyžadováno Typ Description
filters True

WorkspacePurgeBodyFilters[]

Sada sloupců a filtrů (dotazů) pro jejich spuštění, aby se vyprázdnila výsledná data.
table True

string

Tabulka, ze které chcete data vyprázdnit.

Odpovědi

Name Typ Description
202 Accepted

WorkspacePurgeResponse

Přijatá žádost o vymazání pracovního prostoru služby Log Analytics

Hlavičky

x-ms-status-location: string

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
}

Definice

Name Description
WorkspacePurgeBody

Popisuje text žádosti o vymazání pracovního prostoru App Insights.
WorkspacePurgeBodyFilters

Uživatelem definované filtry pro vrácení dat, která se vyprázdní z tabulky.
WorkspacePurgeResponse

Odpověď obsahující id operace pro konkrétní akci vyprázdnění

WorkspacePurgeBody

Objekt

Popisuje text žádosti o vymazání pracovního prostoru App Insights.

Name Typ Description
filters

WorkspacePurgeBodyFilters[]

Sada sloupců a filtrů (dotazů) pro jejich spuštění, aby se vyprázdnila výsledná data.
table

string

Tabulka, ze které chcete data vyprázdnit.

WorkspacePurgeBodyFilters

Objekt

Uživatelem definované filtry pro vrácení dat, která se vyprázdní z tabulky.

Name Typ Description
column

string

Sloupec tabulky, ve které má daný dotaz běžet
key

string

Při filtrování podle vlastních dimenzí se tento klíč použije jako název vlastní dimenze.
operator

string

Operátor dotazu, který se má vyhodnotit nad zadaným sloupcem a hodnotami. Podporované operátory jsou ==, =~, in, in, >, >=, <, <=, between a mají stejné chování jako v dotazu KQL.
value

hodnota operátoru, který má fungovat. Může to být číslo (např. > 100), řetězec (časové razítko >= '2017-09-01') nebo pole hodnot.

WorkspacePurgeResponse

Objekt

Odpověď obsahující id operace pro konkrétní akci vyprázdnění

Name Typ Description
operationId

string

ID, které se má použít při dotazování na stav konkrétní operace vyprázdnění.