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 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 purge afin de 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	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	ID de l’abonnement cible.
api-version	query	True	string	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 sur celles-ci pour vider les données obtenues.
table	True	string	Table à partir de laquelle vider les données.

Réponses

Nom	Type	Description
202 Accepted	ComponentPurgeResponse	Demande acceptée pour purger 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

HTTP

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 purge 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 purge spécifique.

ComponentPurgeBody

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

Nom	Type	Description
filters	ComponentPurgeBodyFilters[]	Ensemble de colonnes et de filtres (requêtes) à exécuter sur celles-ci pour vider les données obtenues.
table	string	Table à partir de laquelle vider les données.

ComponentPurgeBodyFilters

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 sur laquelle l’opérateur doit 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.

ComponentPurgeResponse

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

Nom	Type	Description
operationId	string	ID à utiliser lors de l’interrogation de status pour une opération de purge particulière.

Partager via