Workspace Purge - Purge

Очистка данных в рабочей области Log Analytics с помощью набора пользовательских фильтров.

Для управления системными ресурсами запросы на очистку регулируются со скоростью 50 запросов в час. Вы должны пакетировать выполнение запросов на очистку, отправив одну команду, предикат которой включает все удостоверения пользователей, требующие очистки. Используйте оператор in для указания нескольких идентификаторов. Вы должны выполнить запрос перед использованием запроса на очистку, чтобы убедиться, что результаты ожидаемы. Log Analytics поддерживает только операции очистки, необходимые для соответствия требованиям GDPR. Команда разработчиков Log Analytics оставляет за собой право отклонять запросы на операции очистки, которые не соответствуют требованиям GDPR. В случае возникновения спорных ситуаций создайте запрос в службу поддержки

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не зависит от регистра.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).

workspaceName
path True

string

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

Имя рабочей области.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Текст запроса

Имя Обязательно Тип Описание
filters True

WorkspacePurgeBodyFilters[]

Набор столбцов и фильтров (запросов) для их пробега для очистки полученных данных.

table True

string

Таблица, из которой нужно очистить данные.

Ответы

Имя Тип Описание
202 Accepted

WorkspacePurgeResponse

Операция Azure успешно завершена.

Заголовки

x-ms-status-location: string

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Образец запроса

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.OperationalInsights/workspaces/aztest5048/purge?api-version=2025-07-01

{
  "filters": [
    {
      "column": "TimeGenerated",
      "operator": ">",
      "value": "2017-09-01T00:00:00"
    }
  ],
  "table": "Heartbeat"
}

Пример ответа

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-07-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

WorkspacePurgeResourceId

Образец запроса

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.OperationalInsights/workspaces/aztest5048/purge?api-version=2025-07-01

{
  "filters": [
    {
      "column": "_ResourceId",
      "operator": "==",
      "value": "/subscriptions/12341234-1234-1234-1234-123412341234/resourceGroups/SomeResourceGroup/providers/microsoft.insights/components/AppInsightResource"
    }
  ],
  "table": "Heartbeat"
}

Пример ответа

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-07-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Определения

Имя Описание
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

WorkspacePurgeBody

Описывает текст запроса на очистку для рабочей области App Insights

WorkspacePurgeBodyFilters

Определяемые пользователем фильтры для возврата данных, которые будут удалены из таблицы.

WorkspacePurgeResponse

Ответ, содержащий operationId для определенного действия очистки.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

WorkspacePurgeBody

Описывает текст запроса на очистку для рабочей области App Insights

Имя Тип Описание
filters

WorkspacePurgeBodyFilters[]

Набор столбцов и фильтров (запросов) для их пробега для очистки полученных данных.

table

string

Таблица, из которой нужно очистить данные.

WorkspacePurgeBodyFilters

Определяемые пользователем фильтры для возврата данных, которые будут удалены из таблицы.

Имя Тип Описание
column

string

Столбец таблицы, над которой должен выполняться заданный запрос.

key

string

При фильтрации по пользовательским измерениям этот ключ будет использоваться в качестве имени настраиваемого измерения.

operator

string

Оператор запроса для оценки по заданному столбцу и значениям. Поддерживаемые операторы ==, =~, in, in, =, =, >><<=, =, между и имеют то же поведение, что и в запросе KQL.

value

значение оператора для функции. Это может быть число (например, > 100), строка (метка времени >= '2017-09-01') или массив значений.

WorkspacePurgeResponse

Ответ, содержащий operationId для определенного действия очистки.

Имя Тип Описание
operationId

string

Идентификатор, используемый при запросе состояния для конкретной операции очистки.