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
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя не зависит от регистра. |
|
subscription
|
path | True |
string (uuid) |
Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID). |
|
workspace
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
Имя рабочей области. |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Текст запроса
| Имя | Обязательно | Тип | Описание |
|---|---|---|---|
| filters | True |
Набор столбцов и фильтров (запросов) для их пробега для очистки полученных данных. |
|
| table | True |
string |
Таблица, из которой нужно очистить данные. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 202 Accepted |
Операция Azure успешно завершена. Заголовки x-ms-status-location: string |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
|
Workspace |
|
Workspace |
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"
}
Определения
| Имя | Описание |
|---|---|
|
Error |
Дополнительные сведения об ошибке управления ресурсами. |
|
Error |
Сведения об ошибке. |
|
Error |
Ответ на ошибку |
|
Workspace |
Описывает текст запроса на очистку для рабочей области App Insights |
|
Workspace |
Определяемые пользователем фильтры для возврата данных, которые будут удалены из таблицы. |
|
Workspace |
Ответ, содержащий operationId для определенного действия очистки. |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
| Имя | Тип | Описание |
|---|---|---|
| info |
object |
Дополнительные сведения. |
| type |
string |
Дополнительный тип сведений. |
ErrorDetail
Сведения об ошибке.
| Имя | Тип | Описание |
|---|---|---|
| additionalInfo |
Дополнительные сведения об ошибке. |
|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке. |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
WorkspacePurgeBody
Описывает текст запроса на очистку для рабочей области App Insights
| Имя | Тип | Описание |
|---|---|---|
| filters |
Набор столбцов и фильтров (запросов) для их пробега для очистки полученных данных. |
|
| table |
string |
Таблица, из которой нужно очистить данные. |
WorkspacePurgeBodyFilters
Определяемые пользователем фильтры для возврата данных, которые будут удалены из таблицы.
| Имя | Тип | Описание |
|---|---|---|
| column |
string |
Столбец таблицы, над которой должен выполняться заданный запрос. |
| key |
string |
При фильтрации по пользовательским измерениям этот ключ будет использоваться в качестве имени настраиваемого измерения. |
| operator |
string |
Оператор запроса для оценки по заданному столбцу и значениям. Поддерживаемые операторы ==, =~, in, in, =, =, >><<=, =, между и имеют то же поведение, что и в запросе KQL. |
| value |
значение оператора для функции. Это может быть число (например, > 100), строка (метка времени >= '2017-09-01') или массив значений. |
WorkspacePurgeResponse
Ответ, содержащий operationId для определенного действия очистки.
| Имя | Тип | Описание |
|---|---|---|
| operationId |
string |
Идентификатор, используемый при запросе состояния для конкретной операции очистки. |