Query - Resource Execute

Odwołanie

Usługa:: Log Analytics

Wersja interfejsu API:: 2022-10-27_Preview

Wykonywanie zapytania analizy przy użyciu identyfikatora zasobu
Wykonuje zapytanie analizy dotyczące danych w kontekście zasobu. Oto przykład użycia funkcji POST z zapytaniem analizy.

POST https://api.loganalytics.io/v1/{resourceId}/query

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceId	path	True	string	Identyfikator zasobu.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Prefer		string	Opcjonalny. Preferuj nagłówek ustawiania limitu czasu serwera, statystyk zapytań i informacji o wizualizacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
query	True	string	Zapytanie do wykonania.
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.
workspaces		string[]	Lista obszarów roboczych uwzględnionych w zapytaniu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	queryResults	OK. Wywołanie interfejsu API powiodło się, a wynik zapytania analizy znajduje się w ładunku odpowiedzi
Other Status Codes	errorResponse	Obiekt odpowiedzi o błędzie.

Zabezpieczenia

oauth2

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

simple-query

Przykładowe żądanie

HTTP

POST https://api.loganalytics.io/v1//subscriptions/fffa080af-c2d8-40ad-9cce-e1a450bawb57/resourceGroups/test-resourcegroup/providers/Microsoft.Storage/storageAccounts/storageaccountname/query

{
  "query": "StorageBlobLogs | summarize count() by OperationName | top 10 by count_ desc",
  "timespan": "PT24H"
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "OperationName",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "operation1",
          "10"
        ]
      ]
    }
  ]
}

Definicje

Nazwa	Opis
column	Kolumna tabeli.
errorDetail	Szczegóły błędu.
errorInfo	Kod i komunikat dotyczący błędu.
errorResponse	Szczegóły błędu.
logsColumnType	Typ danych tej kolumny.
queryBody	Zapytanie Analiza. Dowiedz się więcej o składni zapytań analizy
queryResults	Odpowiedź na zapytanie.
Render	Dane wizualizacji w formacie JSON.
Statistics	Statystyki reprezentowane w formacie JSON.
table	Tabela odpowiedzi zapytania.

column

Kolumna tabeli.

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

errorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalProperties	object	Dodatkowe właściwości, które można podać w obiekcie szczegółów błędu
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	Dodatkowe właściwości, które można podać w obiekcie informacji o błędzie
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

Szczegóły błędu.

Nazwa	Typ	Opis
error	errorInfo	Kod i komunikat dotyczący błędu. Szczegóły błędu.

logsColumnType

Typ danych tej kolumny.

Nazwa	Typ	Opis
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

Zapytanie Analiza. Dowiedz się więcej o składni zapytań analizy

Nazwa	Typ	Opis
query	string	Zapytanie do wykonania.
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.
workspaces	string[]	Lista obszarów roboczych uwzględnionych w zapytaniu.

queryResults

Odpowiedź na zapytanie.

Nazwa	Typ	Opis
error	errorInfo	Kod i komunikat dotyczący błędu.
render	Render	Dane wizualizacji w formacie JSON.
statistics	Statistics	Statystyki reprezentowane w formacie JSON.
tables	table[]	Lista tabel, kolumn i wierszy.

Render

Dane wizualizacji w formacie JSON.

Statistics

Statystyki reprezentowane w formacie JSON.

table

Tabela odpowiedzi zapytania.

Nazwa	Typ	Opis
columns	column[]	Lista kolumn w tej tabeli.
name	string	Nazwa tabeli.
rows	object[]	Wynikowe wiersze z tego zapytania.

Udostępnij za pośrednictwem