Format de réponse de l’API Log Analytics Azure Monitor

  • Article

La réponse de l’API Azure Monitor Log Analytics est une chaîne JSON qui contient un groupe d’objets de table.

La propriété tables est un groupe de tables qui représentent le résultat de la requête. Chaque table contient des propriétés name, columns et rows :

  • La propriété name est le nom de la table.
  • La propriété columns est un groupe d’objets qui décrivent le schéma de chaque colonne.
  • La propriété rows est un tableau de valeurs. Chaque élément du tableau représente une ligne dans le jeu de résultats.

Dans l’exemple suivant, nous voyons bien que le résultat contient deux colonnes, à savoir Category et count_. Category est la première colonne. Elle représente la valeur de la colonne Category dans la table AzureActivity. count_ est la deuxième colonne. Elle représente le nombre d’événements dans la table AzureActivity pour la catégorie spécifique.

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    
    {
        "tables": [
            {
                "name": "PrimaryResult",
                "columns": [
                    {
                        "name": "Category",
                        "type": "string"
                    },
                    {
                        "name": "count_",
                        "type": "long"
                    }
                ],
                "rows": [
                    [
                        "Administrative",
                        20839
                    ],
                    [
                        "Recommendation",
                        122
                    ],
                    [
                        "Alert",
                        64
                    ],
                    [
                        "ServiceHealth",
                        11
                    ]
                ]
            }
        ]
    }

Erreurs de l’API Log Analytics Azure Monitor

Si une erreur irrécupérable se produit pendant l’exécution de la requête, un code d’état d’erreur est renvoyé avec un objet d’erreur OneAPI qui décrit l’erreur.

Si une erreur récupérable se produit pendant l’exécution de la requête, le code d’état de la réponse est 200 OK. Cette réponse contient les résultats de la requête dans la propriété tables comme décrite. Elle contient également une propriété error, qui est un objet d’erreur OneAPI avec le code PartialError. Les détails de l’erreur sont inclus dans la propriété details.

Étapes suivantes

Obtenez plus d’informations sur l’utilisation des options d’API.