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 minLength: 1 |
Идентификатор целевой подписки. |
|
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 |
Принят запрос на очистку рабочей области Log Analytics. Заголовки x-ms-status-location: string |
Безопасность
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-00000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.OperationalInsights/workspaces/aztest5048/purge?api-version=2025-07-01
{
"table": "Heartbeat",
"filters": [
{
"column": "TimeGenerated",
"operator": ">",
"value": "2017-09-01T00:00:00"
}
]
}
Пример ответа
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-00000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.OperationalInsights/workspaces/aztest5048/purge?api-version=2025-07-01
{
"table": "Heartbeat",
"filters": [
{
"column": "_ResourceId",
"operator": "==",
"value": "/subscriptions/12341234-1234-1234-1234-123412341234/resourceGroups/SomeResourceGroup/providers/microsoft.insights/components/AppInsightResource"
}
]
}
Пример ответа
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"
}
Определения
| Имя | Описание |
|---|---|
|
Workspace |
Описывает текст запроса на очистку для рабочей области App Insights |
|
Workspace |
Определяемые пользователем фильтры для возврата данных, которые будут удалены из таблицы. |
|
Workspace |
Ответ, содержащий operationId для определенного действия очистки. |
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 |
Идентификатор, используемый при запросе состояния для конкретной операции очистки. |