Compartir a través de

Workspace Purge - Purge

  • Referencia
Servicio:
Log Analytics
Versión de la API:
2023-09-01

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

Con el fin de administrar los recursos del sistema, las solicitudes de purga se limitan a 50 solicitudes por hora. Debe procesar por lotes la ejecución de las solicitudes de purga mediante el envío de un único comando cuyo predicado incluya todas las identidades de usuario que requieran 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 las 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=2023-09-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
 path True

string

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

string

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

string

El nombre del área de trabajo.

Patrón de Regex: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

Versión de API que se usará para la 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 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 suplantación de su 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=2023-09-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=2023-09-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=2023-09-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=2023-09-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

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

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 en una consulta de KQL.
value

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

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.