通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Workspace Purge - Purge

  • 参考
服务:
Log Analytics
API 版本:
2023-09-01

通过一组用户定义的筛选器清除 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=2023-09-01

URI 参数

名称 在 必需 类型 说明
resourceGroupName
 path True

string

资源组的名称。 此名称不区分大小写。
subscriptionId
 path True

string

目标订阅的 ID。
workspaceName
 path True

string

工作区的名称。

正则表达式模式: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

要用于此操作的 API 版本。

请求正文

名称 必需 类型 说明
filters True

WorkspacePurgeBodyFilters[]

列和筛选器集 (查询) 运行，以清除生成的数据。
table True

string

要从中清除数据的表。

响应

名称 类型 说明
202 Accepted

WorkspacePurgeResponse

已接受清除 Log Analytics 工作区的请求。

标头

x-ms-status-location: string

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

示例请求

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

示例响应

状态代码:
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

示例请求

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

示例响应

状态代码:
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"
}

定义

名称 说明
WorkspacePurgeBody

介绍 App Insights 工作区的清除请求的正文
WorkspacePurgeBodyFilters

用户定义的筛选器，用于返回将从表中清除的数据。
WorkspacePurgeResponse

包含特定清除操作的 operationId 的响应。

WorkspacePurgeBody

介绍 App Insights 工作区的清除请求的正文

名称 类型 说明
filters

WorkspacePurgeBodyFilters[]

列和筛选器集 (查询) 运行，以清除生成的数据。
table

string

要从中清除数据的表。

WorkspacePurgeBodyFilters

用户定义的筛选器，用于返回将从表中清除的数据。

名称 类型 说明
column

string

给定查询应在其上运行的表的列
key

string

筛选自定义维度时，此键将用作自定义维度的名称。
operator

string

一个查询运算符，用于对提供的列和值 () 求值。 支持的运算符为 ==、=~、in、in~、>、=、<、、<=、between 和 ，其行为与在 KQL 查询>中的行为相同。
value

要函数的运算符的值。 这可以是数字 (例如 > 100) 、字符串 (timestamp >= '2017-09-01') 或值数组。

WorkspacePurgeResponse

包含特定清除操作的 operationId 的响应。

名称 类型 说明
operationId

string

查询特定清除操作的状态时要使用的 ID。