Query - Execute

Référence

Service:: Log Analytics

Version d'API:: 2022-10-27_Preview

Exécuter une requête Analytics
Exécute une requête Analytics pour les données. Voici un exemple d’utilisation de POST avec une requête Analytics.

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

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 du panneau Propriétés dans le Portail Azure.

En-tête de la demande

Nom	Obligatoire	Type	Description
Prefer		string	facultatif. L’en-tête de préférence pour définir le délai d’attente du serveur, les statistiques de requête et les informations de visualisation.

Corps de la demande

Nom	Obligatoire	Type	Description
query	True	string	Requête à exécuter.
timespan		string	facultatif. Intervalle de temps sur lequel interroger des données. Il s’agit d’une valeur de période ISO8601. Cet intervalle de temps est appliqué en plus de tous les éléments spécifiés dans l’expression de requête.
workspaces		string[]	Liste des espaces de travail inclus dans la requête.

Réponses

Nom	Type	Description
200 OK	queryResults	OK. 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

HTTP

POST https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query

{
  "query": "union * | where TimeGenerated > ago(1h) | summarize count() by Type, TenantId",
  "workspaces": [
    "draft-test",
    "draft-test-2"
  ]
}

Exemple de réponse

Code d’état:: 200

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

HTTP

POST https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query

{
  "query": "Usage | take 10",
  "timespan": "PT12H"
}

Exemple de réponse

Code d’état:: 200

{
  "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 d’une erreur.
errorResponse	Détails de l’erreur.
logsColumnType	Type de données de cette colonne.
queryBody	Requête Analytics. En savoir plus sur la syntaxe de requête Analytics
queryResults	Réponse à une requête.
Render	Visualisation des données 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 responsables de l’erreur.
target	string	Indique la propriété de la requête responsable de l’erreur.
value	string	Indique la valeur dans 'target' qui est responsable de l’erreur.

errorInfo

Code et message d’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 machine.
details	errorDetail[]	détails de l’erreur.
innererror	errorInfo	Code et message d’une erreur. Détails internes de l’erreur 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 d’une erreur. Détails de l’erreur.

logsColumnType

Type de données de cette colonne.

Nom	Type	Description
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryBody

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

Nom	Type	Description
query	string	Requête à exécuter.
timespan	string	facultatif. Intervalle de temps sur lequel interroger des données. Il s’agit d’une valeur de période ISO8601. Cet intervalle de temps est appliqué en plus de tous les éléments spécifiés dans l’expression de requête.
workspaces	string[]	Liste des espaces de travail inclus dans la requête.

queryResults

Réponse à une requête.

Nom	Type	Description
error	errorInfo	Code et message d’une erreur.
render	Render	Visualisation des données au format JSON.
statistics	Statistics	Statistiques représentées au format JSON.
tables	table[]	Liste des tables, colonnes et lignes.

Render

Visualisation des données 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 cette table.
name	string	Nom de la table.
rows	object[]	Lignes résultantes de cette requête.

Partager via

Query - Execute

Paramètres URI

En-tête de la demande

Corps de la demande

Réponses

Sécurité

oauth2

Étendues

Exemples

cross-workspace

Exemple de requête

Exemple de réponse

simple-query

Exemple de requête

Exemple de réponse

Définitions

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryBody

queryResults

Render

Statistics

table

Ressources supplémentaires