Partager via

Workspace Purge - Purge

  • Référence
Service:
Log Analytics
Version d'API:
2023-09-01

Purge les données d’un espace de travail Log Analytics à l’aide d’un ensemble de filtres définis par l’utilisateur.

Pour gérer les ressources système, les demandes de vidage sont limitées à 50 demandes par heure. Vous devez regrouper l’exécution des demandes de vidage en envoyant une seule commande dont le prédicat comprend toutes les identités des utilisateurs qui demandent un vidage. Utilisez l’opérateur in pour spécifier plusieurs identités. Vous devez exécuter la requête avant de l’utiliser pour une demande de vidage afin de vérifier que les résultats sont attendus. Log Analytics prend uniquement en charge les opérations de vidage requises pour la conformité avec le RGPD. L’équipe produit Log Analytics se réserve le droit de rejeter les demandes d’opérations de vidage qui ne sont pas conformes au 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=2023-09-01

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
 path True

string

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

string

ID de l’abonnement cible.
workspaceName
 path True

string

Nom de l’espace de travail.

Modèle d’expression régulière: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

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 sur celles-ci 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 pour le vidage 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=2023-09-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=2023-09-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=2023-09-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=2023-09-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

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 sur celles-ci pour vider les données résultantes.
table

string

Table à partir de laquelle vider les données.

WorkspacePurgeBodyFilters

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 colonne et la ou les valeurs fournies. Les opérateurs pris en charge sont ==, =~, in~, >, >=, <, <=, entre et ont le même comportement que dans une requête KQL.
value

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

WorkspacePurgeResponse

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

Nom Type Description
operationId

string

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