Partager via


Query - Get

Exécuter une requête Analytics
Exécute une requête Analytics pour les données

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}
GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}&timespan={timespan}

Paramètres URI

Nom Dans Obligatoire Type Description
workspaceId
path True

string

ID de l’espace de travail. Il s’agit de l’ID d’espace de travail à partir du panneau Propriétés dans le portail Azure.

query
query True

string

Requête Analytics. En savoir plus sur la syntaxe de requête Analytics

timespan
query

string (duration)

Optionnel. Intervalle de temps sur lequel interroger les données. Il s’agit d’une valeur de période ISO8601. Cet intervalle de temps est appliqué en plus des éléments spécifiés dans l’expression de requête.

Réponses

Nom Type Description
200 OK

queryResults

D’ACCORD. L’appel d’API a réussi et le résultat de la requête Analytics se trouve dans la charge utile de réponse

Other Status Codes

errorResponse

Objet de réponse d’erreur.

Sécurité

oauth2

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

cross-workspace
simple-query

cross-workspace

Exemple de requête

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=union * | where TimeGenerated > ago(1h) | summarize count() by Type, TenantId

Exemple de réponse

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "Type",
          "type": "string"
        },
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "Usage",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "Usage",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "BillingFact",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "BillingFact",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "Operation",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "7"
        ],
        [
          "Operation",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "5"
        ]
      ]
    }
  ]
}

simple-query

Exemple de requête

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=Usage | take 10&timespan=PT12H

Exemple de réponse

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "Computer",
          "type": "string"
        },
        {
          "name": "TimeGenerated",
          "type": "datetime"
        },
        {
          "name": "SourceSystem",
          "type": "string"
        },
        {
          "name": "StartTime",
          "type": "datetime"
        },
        {
          "name": "EndTime",
          "type": "datetime"
        },
        {
          "name": "ResourceUri",
          "type": "string"
        },
        {
          "name": "LinkedResourceUri",
          "type": "string"
        },
        {
          "name": "DataType",
          "type": "string"
        },
        {
          "name": "Solution",
          "type": "string"
        },
        {
          "name": "BatchesWithinSla",
          "type": "long"
        },
        {
          "name": "BatchesOutsideSla",
          "type": "long"
        },
        {
          "name": "BatchesCapped",
          "type": "long"
        },
        {
          "name": "TotalBatches",
          "type": "long"
        },
        {
          "name": "AvgLatencyInSeconds",
          "type": "real"
        },
        {
          "name": "Quantity",
          "type": "real"
        },
        {
          "name": "QuantityUnit",
          "type": "string"
        },
        {
          "name": "IsBillable",
          "type": "bool"
        },
        {
          "name": "MeterId",
          "type": "string"
        },
        {
          "name": "LinkedMeterId",
          "type": "string"
        },
        {
          "name": "Type",
          "type": "string"
        }
      ],
      "rows": [
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "ContosoSQLSrv1",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.286",
          "0.076408",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ],
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "Store010Web3",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.7",
          "0.106767",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ]
      ]
    }
  ]
}

Définitions

Nom Description
column

Colonne de table.

errorDetail

Détails de l’erreur.

errorInfo

Code et message pour une erreur.

errorResponse

Détails de l’erreur.

logsColumnType

Type de données de cette colonne.

queryResults

Réponse à une requête.

Render

Données de visualisation au format JSON.

Statistics

Statistiques représentées au format JSON.

table

Table de réponse de requête.

column

Colonne de table.

Nom Type Description
name

string

Nom de cette colonne.

type

logsColumnType

Type de données de cette colonne.

errorDetail

Détails de l’erreur.

Nom Type Description
additionalProperties

object

Propriétés supplémentaires qui peuvent être fournies sur l’objet détails de l’erreur

code

string

Code de l’erreur.

message

string

Message d’erreur lisible par l’homme.

resources

string[]

Indique les ressources qui ont été responsables de l’erreur.

target

string

Indique quelle propriété dans la demande est responsable de l’erreur.

value

string

Indique quelle valeur dans ' target' est responsable de l’erreur.

errorInfo

Code et message pour une erreur.

Nom Type Description
additionalProperties

object

Propriétés supplémentaires qui peuvent être fournies sur l’objet d’informations d’erreur

code

string

Code d’erreur lisible par l’ordinateur.

details

errorDetail[]

détails de l’erreur.

innererror

errorInfo

Code et message pour une erreur.
Détails de l’erreur interne s’ils existent.

message

string

Message d’erreur lisible par l’homme.

errorResponse

Détails de l’erreur.

Nom Type Description
error

errorInfo

Code et message pour une erreur.
Détails de l’erreur.

logsColumnType

Type de données de cette colonne.

Valeur Description
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryResults

Réponse à une requête.

Nom Type Description
error

errorInfo

Code et message pour une erreur.

render

Render

Données de visualisation au format JSON.

statistics

Statistics

Statistiques représentées au format JSON.

tables

table[]

Liste des tables, colonnes et lignes.

Render

Données de visualisation au format JSON.

Statistics

Statistiques représentées au format JSON.

table

Table de réponse de requête.

Nom Type Description
columns

column[]

Liste des colonnes de ce tableau.

name

string

Nom de la table.

rows

object[]

Lignes résultantes de cette requête.