Workspace Purge - Purge

一連のユーザー定義フィルターによって Log Analytics ワークスペース内のデータを消去します。

システム リソースを管理するために、消去要求は 1 時間あたり 50 要求に制限されます。 消去要求の実行をバッチ処理するには、消去が必要なすべてのユーザー ID を述語に含む 1 つのコマンドを送信します。 複数の ID を指定するには、in 演算子を使用します。 消去要求に を使用する前にクエリを実行して、結果が期待されることを確認する必要があります。 Log Analytics では、GDPR への準拠に必要な消去操作のみがサポートされます。 Log Analytics 製品チームは、GDPR コンプライアンスを目的としていない消去操作の要求を拒否する権利を留保します。 紛争が発生した場合は、サポート チケットを作成してください

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

URI パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

リソース グループの名前。 名前の大文字と小文字は区別されます。

subscriptionId
path True

string

ターゲット サブスクリプションの ID。

workspaceName
path True

string

ワークスペースの名前。

Regex pattern: ^[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 ワークスペースの消去要求を受け入れた。

Headers

x-ms-status-location: string

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前 説明
user_impersonation ユーザー アカウントの借用

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Sample Request

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

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

Sample Response

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

WorkspacePurgeResourceId

Sample Request

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

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

Sample Response

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=2020-08-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。