Query - Execute

Odwołanie

Usługa:: Application Insights

Wersja interfejsu API:: v1

Wykonywanie zapytania analizy
Wykonuje zapytanie analizy dla danych. Oto przykład użycia funkcji POST z zapytaniem analizy.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
appId	path	True	string	Identyfikator aplikacji. Jest to identyfikator aplikacji w bloku Ustawienia dostępu do interfejsu API w Azure Portal.

Treść żądania

Nazwa	Wymagane	Typ	Opis
query	True	string	Zapytanie do wykonania.
applications		string[]	Lista identyfikatorów aplikacji dla zapytań między aplikacjami.
timespan		string	Opcjonalny. Przedział czasu, na którym ma być wysyłane zapytanie o dane. Jest to wartość okresu ISO8601. Ten przedział czasu jest stosowany oprócz każdego określonego w wyrażeniu zapytania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	queryResults	Pomyślna odpowiedź
Other Status Codes	errorResponse	Obiekt odpowiedzi o błędzie.

Zabezpieczenia

oauth2

Nawiązywanie połączenia z interfejsem API usługi aplikacja systemu Azure Insights

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

queryPost

Przykładowe żądanie

HTTP

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

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

Przykładowa odpowiedź

Kod stanu:: 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"
        ]
      ]
    }
  ]
}

Definicje

Nazwa	Opis
column	Kolumna tabeli.
errorDetail	Szczegóły błędu.
errorInfo	Kod i komunikat dotyczący błędu.
errorResponse	Szczegóły błędu.
queryBody	Zapytanie Analiza. Dowiedz się więcej o składni zapytań analizy
queryResults	Odpowiedź na zapytanie.
table	Tabela odpowiedzi zapytania.

column

Kolumna tabeli.

Nazwa	Typ	Opis
name	string	Nazwa tej kolumny.
type	string	Typ danych tej kolumny.

errorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalProperties	object
code	string	Kod błędu.
message	string	Komunikat o błędzie czytelny dla człowieka.
resources	string[]	Wskazuje zasoby, które były odpowiedzialne za błąd.
target	string	Wskazuje, która właściwość w żądaniu jest odpowiedzialna za błąd.
value	string	Wskazuje, która wartość w obiekcie docelowym jest odpowiedzialna za błąd.

errorInfo

Kod i komunikat dotyczący błędu.

Nazwa	Typ	Opis
additionalProperties	object
code	string	Kod błędu z możliwością odczytu maszyny.
details	errorDetail[]	szczegóły błędu.
innererror	errorInfo	Kod i komunikat dotyczący błędu. Szczegóły błędu wewnętrznego, jeśli istnieją.
message	string	Komunikat o błędzie czytelny dla człowieka.

errorResponse