Sdílet prostřednictvím

Workspace Purge - Purge

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

Vyčisí data v pracovním prostoru služby Log Analytics pomocí sady uživatelsky definovaných filtrů.

Aby bylo možné spravovat systémové prostředky, požadavky na vyprázdnění se omezují rychlostí 50 požadavků za hodinu. Spuštění požadavků na vymazá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í. K určení více identit použijte operátor in. Před použitím příkazu pro žádost o vymazání byste měli spustit dotaz, abyste ověřili, že jsou výsledky očekávané. Log Analytics podporuje pouze operace mazání, které jsou nutné pro dodržování předpisů GDPR. Produktový tým Log Analytics si vyhrazuje právo odmítnout žádosti o operace mazání, které nejsou určené pro účely dodržování předpisů 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

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.
subscriptionId
 path True

string

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

string

Název pracovního prostoru.

Vzor regulárního výrazu: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

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ů), které se mají spustit, aby se vyprázdnila výsledná data.
table True

string

Tabulka, ze které chcete vyprázdnit data.

Odpovědi

Name Typ Description
202 Accepted

WorkspacePurgeResponse

Byla přijata žádost o vymazání pracovního prostoru služby Log Analytics.

Hlavičky

x-ms-status-location: string

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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 vrátí data, která se z tabulky vymažou.
WorkspacePurgeResponse

Odpověď obsahující operationId pro konkrétní akci vyprázdnění.

WorkspacePurgeBody

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

Name Typ Description
filters

WorkspacePurgeBodyFilters[]

Sada sloupců a filtrů (dotazů), které se mají spustit, aby se vyprázdnila výsledná data.
table

string

Tabulka, ze které chcete vyprázdnit data.

WorkspacePurgeBodyFilters

Uživatelem definované filtry vrátí data, která se z tabulky vymažou.

Name Typ Description
column

string

Sloupec tabulky, nad kterou se má daný dotaz spustit
key

string

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

string

Operátor dotazu, který vyhodnotí zadaný sloupec a hodnoty. 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 matice hodnot.

WorkspacePurgeResponse

Odpověď obsahující operationId pro konkrétní akci vyprázdnění.

Name Typ Description
operationId

string

ID, které se použije při dotazování na stav konkrétní operace vymazání.