次の方法で共有

Workspace Purge - Purge

  • リファレンス
サービス:
Log Analytics
API バージョン:
2023-09-01

一連のユーザー定義フィルターによって 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=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
Authorization URL (承認 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。