Query - Resource Execute

Service:

Log Analytics

API Version:

2022-10-27_Preview

Spuštění analytického dotazu s použitím ID prostředku
Spustí analytický dotaz na data v kontextu prostředku. Tady je příklad použití příkazu POST s analytickým dotazem.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceId	path	True	string	Identifikátor prostředku.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Prefer		string	Nepovinný parametr. Preferuje hlavičku pro nastavení časového limitu serveru, statistiky dotazů a informací o vizualizaci.

Text požadavku

Name	Vyžadováno	Typ	Description
query	True	string	Dotaz, který se má provést.
timespan		string	Nepovinný parametr. Časový rozsah, pro který se má dotazovat na data. Jedná se o ISO8601 hodnotu časového období. Tento časový rozsah se použije kromě všech, které jsou zadané ve výrazu dotazu.
workspaces		string[]	Seznam pracovních prostorů, které jsou součástí dotazu.

Odpovědi

Name	Typ	Description
200 OK	queryResults	OK. Volání rozhraní API bylo úspěšné a výsledek analytického dotazu je v datové části odpovědi.
Other Status Codes	errorResponse	Objekt odpovědi na chybu.

Zabezpečení

oauth2

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

simple-query

Sample Request

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"
}

Sample Response

Status code:

200

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

Definice

Name	Description
column	Sloupec tabulky.
errorDetail	Podrobnosti o chybě.
errorInfo	Kód a zpráva o chybě.
errorResponse	Podrobnosti o chybě.
logsColumnType	Datový typ tohoto sloupce.
queryBody	Analytický dotaz. Další informace o syntaxi analytických dotazů
queryResults	Odpověď na dotaz.
Render	Vizualizační data ve formátu JSON.
Statistics	Statistika reprezentovaná ve formátu JSON
table	Tabulka odpovědí na dotaz

column

Sloupec tabulky.

Name	Typ	Description
name	string	Název tohoto sloupce
type	logsColumnType	Datový typ tohoto sloupce.

errorDetail

Podrobnosti o chybě.

Name	Typ	Description
additionalProperties	object	Další vlastnosti, které lze zadat u objektu podrobností o chybě
code	string	Kód chyby.
message	string	Chybová zpráva čitelná pro člověka.
resources	string[]	Označuje prostředky, které byly zodpovědné za chybu.
target	string	Určuje, která vlastnost v požadavku je za chybu zodpovědná.
value	string	Určuje, která hodnota v cílovém objektu je zodpovědná za chybu.

errorInfo

Kód a zpráva o chybě.

Name	Typ	Description
additionalProperties	object	Další vlastnosti, které je možné zadat u objektu informací o chybě
code	string	Strojově čitelný kód chyby.
details	errorDetail[]	podrobnosti o chybě.
innererror	errorInfo	Kód a zpráva o chybě. Podrobnosti o vnitřní chybě, pokud existují.
message	string	Chybová zpráva čitelná pro člověka.

errorResponse

Podrobnosti o chybě.

Name	Typ	Description
error	errorInfo	Kód a zpráva o chybě. Podrobnosti o chybě.

logsColumnType

Datový typ tohoto sloupce.

Name	Typ	Description
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

Analytický dotaz. Další informace o syntaxi analytických dotazů

Name	Typ	Description
query	string	Dotaz, který se má provést.
timespan	string	Nepovinný parametr. Časový rozsah, pro který se má dotazovat na data. Jedná se o ISO8601 hodnotu časového období. Tento časový rozsah se použije kromě všech, které jsou zadané ve výrazu dotazu.
workspaces	string[]	Seznam pracovních prostorů, které jsou součástí dotazu.

queryResults

Odpověď na dotaz.

Name	Typ	Description
error	errorInfo	Kód a zpráva o chybě.
render	Render	Vizualizační data ve formátu JSON.
statistics	Statistics	Statistika reprezentovaná ve formátu JSON
tables	table[]	Seznam tabulek, sloupců a řádků.

Render

Vizualizační data ve formátu JSON.

Statistics

Statistika reprezentovaná ve formátu JSON

table

Tabulka odpovědí na dotaz

Name	Typ	Description
columns	column[]	Seznam sloupců v této tabulce
name	string	Název tabulky.
rows	object[]	Výsledné řádky z tohoto dotazu