Query - Execute

Référence

Service:: Application Insights

Version d'API:: v1

Exécuter une requête Analytics
Exécute une requête Analytics pour les données. Voici un exemple d’utilisation de POST avec une requête Analytics.

POST https://api.applicationinsights.io/v1/apps/{appId}/query

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
appId	path	True	string	ID de l’application. Il s’agit de l’ID d’application du panneau Des paramètres d’accès à l’API dans le Portail Azure.

Corps de la demande

Nom	Obligatoire	Type	Description
query	True	string	Requête à exécuter.
applications		string[]	Liste des ID d’application pour les requêtes inter-applications.
timespan		string	facultatif. Intervalle de temps sur lequel interroger des données. Il s’agit d’une valeur de période ISO8601. Cet intervalle de temps est appliqué en plus de tous les éléments spécifiés dans l’expression de requête.

Réponses

Nom	Type	Description
200 OK	queryResults	Réponse correcte
Other Status Codes	errorResponse	Objet de réponse d’erreur.

Sécurité

oauth2

Se connecter à l’API Azure Application Insights

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Étendues

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

Exemples

queryPost

Exemple de requête

HTTP

POST https://api.applicationinsights.io/v1/apps/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/query

{
  "timespan": "PT12H",
  "query": "requests | summarize count() by bin(timestamp, 1h)"
}

Exemple de réponse

Code d’état:: 200

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "timestamp",
          "type": "datetime"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "2018-02-02T05:00:00Z",
          "255"
        ],
        [
          "2018-02-01T17:00:00Z",
          "148"
        ],
        [
          "2018-02-01T18:00:00Z",
          "453"
        ],
        [
          "2018-02-01T19:00:00Z",
          "404"
        ],
        [
          "2018-02-01T20:00:00Z",
          "403"
        ],
        [
          "2018-02-01T21:00:00Z",
          "405"
        ],
        [
          "2018-02-01T22:00:00Z",
          "438"
        ],
        [
          "2018-02-01T23:00:00Z",
          "403"
        ],
        [
          "2018-02-02T00:00:00Z",
          "423"
        ],
        [
          "2018-02-02T01:00:00Z",
          "403"
        ],
        [
          "2018-02-02T02:00:00Z",
          "425"
        ],
        [
          "2018-02-02T03:00:00Z",
          "437"
        ],
        [
          "2018-02-02T04:00:00Z",
          "420"
        ]
      ]
    }
  ]
}

Définitions

Nom	Description
column	Colonne de table.
errorDetail	Détails de l’erreur.
errorInfo	Code et message d’une erreur.
errorResponse	Détails de l’erreur.
queryBody	Requête Analytics. En savoir plus sur la syntaxe de requête Analytics
queryResults	Réponse à une requête.
table	Table de réponse de requête.

column

Colonne de table.

Nom	Type	Description
name	string	Nom de cette colonne.
type	string	Type de données de cette colonne.

errorDetail

Détails de l’erreur.

Nom	Type	Description
additionalProperties	object
code	string	Code de l’erreur.
message	string	Message d’erreur lisible par l’homme.
resources	string[]	Indique les ressources responsables de l’erreur.
target	string	Indique la propriété de la requête responsable de l’erreur.
value	string	Indique la valeur dans 'target' qui est responsable de l’erreur.

errorInfo

Code et message d’une erreur.

Nom	Type	Description
additionalProperties	object
code	string	Code d’erreur lisible par machine.
details	errorDetail[]	détails de l’erreur.
innererror	errorInfo	Code et message d’une erreur. Détails internes de l’erreur s’ils existent.
message	string	Message d’erreur lisible par l’homme.

errorResponse