在 Azure Monitor 日志中配置数据保留和存档策略

若要在 Azure 门户中为表设置保留期和存档持续时间，请执行以下操作：

1. 从“Log Analytics 工作区”菜单中，选择“表”。

   “表”屏幕列出了工作区中的所有表。

2. 选择要配置的表的上下文菜单，然后选择“管理表”。

   

3. 在表配置屏幕的“数据保留设置”部分配置保留期和存档持续时间。

   

若要设置表的保留和存档持续时间，请调用“表 - Update”API：

PATCH https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2021-12-01-preview

可以使用 PUT 或 PATCH，这二者具有以下差异：

• 如果你未设置非 null 值，PUT API 会将 retentionInDays 和 totalRetentionInDays 设置为默认值。
• PATCH API 不会更改 retentionInDays 或 totalRetentionInDays 值（如果你未指定值）。

请求正文

请求正文包含下表中的值。

示例

此示例将表的交互式保留期设置为工作区默认的 30 天，并将总保留期设置为两年，这意味着存档持续时间为 23 个月。

请求

PATCH https://management.chinacloudapi.cn/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/testRG/providers/Microsoft.OperationalInsights/workspaces/testWS/tables/CustomLog_CL?api-version=2021-12-01-preview

请求正文

{
    "properties": {
        "retentionInDays": null,
        "totalRetentionInDays": 730
    }
}

响应

状态代码：200

{
    "properties": {
        "retentionInDays": 30,
        "totalRetentionInDays": 730,
        "archiveRetentionInDays": 700,
        ...        
    },
   ...
}

若要为表设置保留期和存档持续时间，请运行 az monitor log-analytics workspace table update 命令，并传递 --retention-time 和 --total-retention-time 参数。

此示例将表的交互式保留期设置为 30 天，总保留期设置为两年，这意味着存档持续时间为 23 个月：

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name AzureMetrics --retention-time 30 --total-retention-time 730

若要将工作区的默认交互式保留期值重新应用到表，并将其总保留期重置为 0，请运行 az monitor log-analytics workspace table update 命令，运行时其 --retention-time 和 --total-retention-time 参数设置为 -1。

例如：

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name Syslog --retention-time -1 --total-retention-time -1

使用 Update-AzOperationalInsightsTable cmdlet 来设置表的保留期和存档持续时间。 此示例将表的交互式保留期设置为 30 天，总保留期设置为两年，这意味着存档持续时间为 23 个月：

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName AzureMetrics -RetentionInDays 30 -TotalRetentionInDays 730

若要将工作区的默认交互式保留期值重新应用到表，并将其总保留期重置为 0，请运行 Update-AzOperationalInsightsTable cmdlet，-RetentionInDays 和 -TotalRetentionInDays 参数设置为 -1。

例如：

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName Syslog -RetentionInDays -1 -TotalRetentionInDays -1

若要查看 Azure 门户中表的保留和存档时间，请从“Log Analytics 工作区”菜单中选择“表”。

“表”屏幕会显示工作区中所有表的交互式保留期和存档期。

若要获取某个特定表的保留策略（在此示例中为 SecurityEvent），请调用“表 - Get”API：

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables/SecurityEvent?api-version=2021-12-01-preview

若要获取工作区中的所有表级保留策略，请不要设置表名。

例如：

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables?api-version=2021-12-01-preview

若要获取某个特定表的保留策略，请运行 az monitor log-analytics workspace table show 命令。

例如：

az monitor log-analytics workspace table show --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name SecurityEvent

若要获得特定表的保留策略，请运行 Get-AzOperationalInsightsTable cmdlet。

例如：

Get-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -tableName SecurityEvent