Compartir a través de

Workspace Purge - Purge

  • Referencia
Servicio:
Log Analytics
Versión de la API:
2025-02-01

Purga los datos de un área de trabajo de Log Analytics mediante un conjunto de filtros definidos por el usuario.

Para administrar los recursos del sistema, las solicitudes de purga se limitan a 50 solicitudes por hora. Debe procesar por lotes la ejecución de solicitudes de purga enviando un único comando cuyo predicado incluye todas las identidades de usuario que requieren purga. Use el operador in para especificar varias identidades. Debe ejecutar la consulta antes de usar para una solicitud de purga para comprobar que se esperan los resultados. Log Analytics solo admite operaciones de purga necesarias para el cumplimiento del RGPD. El equipo de productos de Log Analytics se reserva el derecho de rechazar solicitudes de operaciones de purga que no sean para el cumplimiento del RGPD. En caso de disputa, cree una incidencia de soporte técnico.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId
 path True

string

minLength: 1

Identificador de la suscripción de destino.
workspaceName
 path True

string

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

Nombre del área de trabajo.
api-version
 query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
filters True

WorkspacePurgeBodyFilters[]

Conjunto de columnas y filtros (consultas) para ejecutarlos para purgar los datos resultantes.
table True

string

Tabla de la que se van a purgar los datos.

Respuestas

Nombre Tipo Description
202 Accepted

WorkspacePurgeResponse

Solicitud aceptada para purgar un área de trabajo de Log Analytics.

Encabezados

x-ms-status-location: string

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
}

Definiciones

Nombre Description
WorkspacePurgeBody

Describe el cuerpo de una solicitud de purga para un área de trabajo de App Insights.
WorkspacePurgeBodyFilters

Filtros definidos por el usuario para devolver datos que se purgarán de la tabla.
WorkspacePurgeResponse

Respuesta que contiene operationId para una acción de purga específica.

WorkspacePurgeBody

Object

Describe el cuerpo de una solicitud de purga para un área de trabajo de App Insights.

Nombre Tipo Description
filters

WorkspacePurgeBodyFilters[]

Conjunto de columnas y filtros (consultas) para ejecutarlos para purgar los datos resultantes.
table

string

Tabla de la que se van a purgar los datos.

WorkspacePurgeBodyFilters

Object

Filtros definidos por el usuario para devolver datos que se purgarán de la tabla.

Nombre Tipo Description
column

string

Columna de la tabla en la que se debe ejecutar la consulta especificada
key

string

Al filtrar por dimensiones personalizadas, esta clave se usará como nombre de la dimensión personalizada.
operator

string

Operador de consulta que se va a evaluar sobre la columna y los valores proporcionados. Los operadores admitidos son ==, =~, in, in~, >, >=, <, <=, entre y tienen el mismo comportamiento que lo harían en una consulta KQL.
value

el valor del operador en el que se va a funcionar. Puede ser un número (por ejemplo, > 100), una cadena (marca de tiempo >= '2017-09-01') o una matriz de valores.

WorkspacePurgeResponse

Object

Respuesta que contiene operationId para una acción de purga específica.

Nombre Tipo Description
operationId

string

Identificador que se va a usar al consultar el estado de una operación de purga determinada.