Partilhar via

Workspace Purge - Purge

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

Remove dados numa área de trabalho do Log Analytics por um conjunto de filtros definidos pelo utilizador.

Para gerir os recursos do sistema, os pedidos de remoção são limitados a 50 pedidos por hora. Deve colocar em lote a execução de pedidos de remoção ao enviar um único comando cujo predicado inclui todas as identidades de utilizador que requerem a remoção. Utilize o operador in para especificar múltiplas identidades. Deve executar a consulta antes de utilizar para um pedido de remoção para verificar se os resultados são esperados. O Log Analytics só suporta operações de remoção necessárias para a conformidade com o RGPD. A equipa de produtos do Log Analytics reserva-se o direito de rejeitar pedidos de operações de remoção que não se destinam à conformidade do RGPD. Em caso de litígio, crie um pedido de suporte

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
 path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
subscriptionId
 path True

string

O ID da subscrição de destino.
workspaceName
 path True

string

O nome da área de trabalho.

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 utilizar para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
filters True

WorkspacePurgeBodyFilters[]

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

string

Tabela a partir da qual remover dados.

Respostas

Name Tipo Description
202 Accepted

WorkspacePurgeResponse

Pedido aceite para remover uma área de trabalho do Log Analytics.

Cabeçalhos

x-ms-status-location: string

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Pedido de amostra

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 da amostra

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

Pedido de amostra

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 da amostra

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

Name Description
WorkspacePurgeBody

Descreve o corpo de um pedido de remoção de uma Área de Trabalho do App Insights
WorkspacePurgeBodyFilters

Filtros definidos pelo utilizador para devolver dados que serão removidos da tabela.
WorkspacePurgeResponse

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

WorkspacePurgeBody

Descreve o corpo de um pedido de remoção de uma Área de Trabalho do App Insights

Name Tipo Description
filters

WorkspacePurgeBodyFilters[]

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

string

Tabela a partir da qual remover dados.

WorkspacePurgeBodyFilters

Filtros definidos pelo utilizador para devolver dados que serão removidos da tabela.

Name Tipo Description
column

string

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

string

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

string

Um operador de consulta para avaliar sobre as colunas e valores fornecidos. Os operadores suportados são ==, =~, in, in~, >, >=, <, <=, entre e têm o mesmo comportamento que teriam numa consulta KQL.
value

o valor para o operador funcionar. Pode ser um número (por exemplo, > 100), uma cadeia (carimbo de data/hora >= '2017-09-01') ou uma matriz de valores.

WorkspacePurgeResponse

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

Name Tipo Description
operationId

string

ID a utilizar ao consultar o estado de uma determinada operação de remoção.