Compartilhar via

Workspace Purge - Purge

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

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

Para gerenciar recursos do sistema, as solicitações de limpeza são limitadas a 50 solicitações por hora. Você deve colocar em lote a execução de 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 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 RGPD. A equipe de produtos do Log Analytics se reserva o direito de rejeitar solicitações para operações de limpeza que não são para fins de conformidade com o RGPD. 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=2025-02-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

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

string

minLength: 1

A ID da assinatura de destino.
workspaceName
 path True

string

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

O nome do workspace.
api-version
 query True

string

minLength: 1

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 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=2025-02-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=2025-02-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=2025-02-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=2025-02-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 removidos da tabela.
WorkspacePurgeResponse

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

WorkspacePurgeBody

Objeto

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

Objeto

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

Nome Tipo Description
column

string

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

string

Ao filtrar 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 para o operador funcionar. Pode ser um número (por exemplo, > 100), uma cadeia de caracteres (>de carimbo de data/hora = '2017-09-01') ou uma matriz de valores.

WorkspacePurgeResponse

Objeto

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

Nome Tipo Description
operationId

string

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