Partager via

Workspace Purge - Purge

  • Référence
Service:
Log Analytics
Version d'API:
2025-02-01

Vide les données dans un espace de travail Log Analytics par un ensemble de filtres définis par l’utilisateur.

Pour gérer les ressources système, les demandes de vidage sont limitées à 50 requêtes par heure. Vous devez traiter par lot l’exécution des demandes de vidage en envoyant une seule commande dont le prédicat inclut toutes les identités utilisateur qui nécessitent une purge. Utilisez l’opérateur in pour spécifier plusieurs identités. Vous devez exécuter la requête avant d’utiliser une demande de vidage pour vérifier que les résultats sont attendus. Log Analytics prend uniquement en charge les opérations de vidage requises pour la conformité au RGPD. L’équipe produit Log Analytics se réserve le droit de rejeter les demandes d’opérations de vidage qui ne sont pas destinées à la conformité RGPD. En cas de litige, créez un ticket de support

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId
 path True

string

minLength: 1

ID de l’abonnement cible.
workspaceName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Nom de l’espace de travail.
api-version
 query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
filters True

WorkspacePurgeBodyFilters[]

Ensemble de colonnes et de filtres (requêtes) à exécuter pour vider les données résultantes.
table True

string

Table à partir de laquelle vider les données.

Réponses

Nom Type Description
202 Accepted

WorkspacePurgeResponse

Demande acceptée de purge d’un espace de travail Log Analytics.

En-têtes

x-ms-status-location: string

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

WorkspacePurge
WorkspacePurgeResourceId

WorkspacePurge

Exemple de requête

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

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

Exemple de réponse

Code d’état:
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=2025-02-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

WorkspacePurgeResourceId

Exemple de requête

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

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

Exemple de réponse

Code d’état:
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=2025-02-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Définitions

Nom Description
WorkspacePurgeBody

Décrit le corps d’une demande de vidage pour un espace de travail App Insights
WorkspacePurgeBodyFilters

Filtres définis par l’utilisateur pour retourner des données qui seront vidées de la table.
WorkspacePurgeResponse

Réponse contenant operationId pour une action de vidage spécifique.

WorkspacePurgeBody

Object

Décrit le corps d’une demande de vidage pour un espace de travail App Insights

Nom Type Description
filters

WorkspacePurgeBodyFilters[]

Ensemble de colonnes et de filtres (requêtes) à exécuter pour vider les données résultantes.
table

string

Table à partir de laquelle vider les données.

WorkspacePurgeBodyFilters

Object

Filtres définis par l’utilisateur pour retourner des données qui seront vidées de la table.

Nom Type Description
column

string

Colonne de la table sur laquelle la requête donnée doit s’exécuter
key

string

Lors du filtrage sur des dimensions personnalisées, cette clé est utilisée comme nom de la dimension personnalisée.
operator

string

Opérateur de requête à évaluer sur la ou les valeurs fournies. Les opérateurs pris en charge sont ==, =~, in, in~ , >, >=, <, <=, between et ont le même comportement que dans une requête KQL.
value

valeur de l’opérateur sur laquelle fonctionner. Il peut s’agir d’un nombre (par exemple, > 100), d’une chaîne (horodatage >= '2017-09-01') ou d’un tableau de valeurs.

WorkspacePurgeResponse

Object

Réponse contenant operationId pour une action de vidage spécifique.

Nom Type Description
operationId

string

ID à utiliser lors de l’interrogation de l’état d’une opération de vidage particulière.