Partager via

Components - Purge

  • Référence
Service:
Application Insights
Version d'API:
2015-05-01

Vide les données d’un composant Application Insights 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.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/purge?api-version=2015-05-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.
resourceName
 path True

string

Nom de la ressource du composant Application Insights.
subscriptionId
 path True

string

minLength: 1

ID de l’abonnement cible.
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

ComponentPurgeBodyFilters[]

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

ComponentPurgeResponse

Demande acceptée de purge d’un composant Application Insights.

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

ComponentPurge

Exemple de requête

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/OIAutoRest5123/providers/Microsoft.Insights/components/aztest5048/purge?api-version=2015-05-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.insights/components/test/operations/purge-970318e7-b859-4edb-8903-83b1b54d0b74?api-version=2015-05-01
{
  "operationId": "7d7cf277-9113-4ab3-8359-d0364b74d01d"
}

Définitions

Nom Description
ComponentPurgeBody

Décrit le corps d’une demande de vidage pour un composant App Insights
ComponentPurgeBodyFilters

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

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

ComponentPurgeBody

Object

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

Nom Type Description
filters

ComponentPurgeBodyFilters[]

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.

ComponentPurgeBodyFilters

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.

ComponentPurgeResponse

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.