Antwortformat der Azure Monitor Log Analytics-API

Die Antwort der Azure Monitor Log Analytics-API liegt als JSON-Zeichenfolge vor, die ein Array mit Tabellenobjekten enthält.

Die Eigenschaft tables ist ein Array von Tabellen, das das Abfrageergebnis darstellt. Jede Tabelle enthält die Eigenschaften name, columns und rows:

  • Die Eigenschaft name ist der Name der Tabelle.
  • Die Eigenschaft columns ist ein Array von Objekten, das das Schema jeder Spalte beschreibt.
  • Die Eigenschaft rows ist ein Array von Werten. Jedes Element im Array stellt eine Zeile im Resultset dar.

Im folgenden Beispiel sehen wir, dass das Ergebnis zwei Spalten enthält: Category und count_. Die erste Spalte Category stellt den Wert der Category-Spalte in der AzureActivity-Tabelle dar. Die zweite Spalte count_ ist die Anzahl der Ereignisse in der AzureActivity-Tabelle für die bestimmte Kategorie.

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

Fehler der Azure Monitor Log Analytics-API

Wenn während der Abfrageausführung ein schwerwiegender Fehler auftritt, wird ein Fehlerstatuscode mit dem Fehlerobjekt OneAPI zurückgegeben, das den Fehler beschreibt.

Falls während der Abfrageausführung ein nicht schwerwiegender Fehler auftritt, lautet der Statuscode der Antwort 200 OK. Sie enthält wie beschrieben die Abfrageergebnisse in der tables-Eigenschaft. Die Antwort enthält außerdem die Eigenschaft error, bei der es sich um ein OneAPI-Fehlerobjekt mit dem Code PartialError handelt. Details zum Fehler sind in der Eigenschaft details enthalten.

Nächste Schritte

Informieren Sie sich ausführlicher über die Verwendung der API-Optionen.