Compartilhar via

Workspace Purge - Purge

  • Referência
Serviço:
Log Analytics
Versão da API:
2023-09-01

Limpa dados em um workspace do Log Analytics por um conjunto de filtros definidos pelo usuário.

Para gerenciar recursos do sistema, há um limite de 50 solicitações de limpeza por hora. Você deve executar em lote as solicitações de limpeza enviando um único comando cujo predicado inclui todas as identidades de usuário que exigem limpeza. Use o operador in para especificar várias identidades. Você deve executar a consulta antes de usar para uma solicitação de limpeza para verificar se os resultados são esperados. O Log Analytics só dá suporte a operações de limpeza necessárias para conformidade com o GDPR. A equipe de produtos do Log Analytics reserva-se o direito de rejeitar solicitações para operações de limpeza que não são para fins de conformidade com GDPR. No caso de uma disputa, crie um tíquete de suporte

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
 path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.
subscriptionId
 path True

string

A ID da assinatura de destino.
workspaceName
 path True

string

O nome do workspace.

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

string

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
filters True

WorkspacePurgeBodyFilters[]

O conjunto de colunas e filtros (consultas) a serem executados sobre eles para limpar os dados resultantes.
table True

string

Tabela da qual limpar dados.

Respostas

Nome Tipo Description
202 Accepted

WorkspacePurgeResponse

Solicitação aceita para limpar um workspace do Log Analytics.

Cabeçalhos

x-ms-status-location: string

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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"
}

Definições

Nome Description
WorkspacePurgeBody

Descreve o corpo de uma solicitação de limpeza para um workspace do App Insights
WorkspacePurgeBodyFilters

Filtros definidos pelo usuário para retornar dados que serão limpos da tabela.
WorkspacePurgeResponse

Resposta que contém operationId para uma ação de limpeza específica.

WorkspacePurgeBody

Descreve o corpo de uma solicitação de limpeza para um workspace do App Insights

Nome Tipo Description
filters

WorkspacePurgeBodyFilters[]

O conjunto de colunas e filtros (consultas) a serem executados sobre eles para limpar os dados resultantes.
table

string

Tabela da qual limpar dados.

WorkspacePurgeBodyFilters

Filtros definidos pelo usuário para retornar dados que serão limpos da tabela.

Nome Tipo Description
column

string

A coluna da tabela sobre a qual a consulta determinada deve ser executada
key

string

Ao filtrar por dimensões personalizadas, essa chave será usada como o nome da dimensão personalizada.
operator

string

Um operador de consulta a ser avaliado sobre a coluna e os valores fornecidos. Os operadores com suporte são ==, =~, in, in~, >, >=, <, <=, between e têm o mesmo comportamento que em uma consulta KQL.
value

o valor do operador sobre o qual o operador funcionará. Isso pode ser um número (por exemplo, > 100), uma cadeia de caracteres (carimbo de data/hora >= '2017-09-01') ou uma matriz de valores.

WorkspacePurgeResponse

Resposta que contém operationId para uma ação de limpeza específica.

Nome Tipo Description
operationId

string

ID a ser usada ao consultar status para uma operação de limpeza específica.