Sdílet prostřednictvím


Query - Resource Execute

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

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

simple-query

Ukázkový požadavek

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

Ukázková odpověď

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