Query - Execute

リファレンス

サービス:: Log Analytics

API バージョン:: 2022-10-27_Preview

Analytics クエリを実行する
データに対して Analytics クエリを実行します。ここでは、分析クエリで POST を使用する例です。

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

URI パラメーター

名前	/	必須	型	説明
workspaceId	path	True	string	ワークスペースの ID。これは、Azure portal の [プロパティ] ブレードのワークスペース ID です。

要求ヘッダー

名前	必須	型	説明
Prefer		string	任意サーバータイムアウト、クエリ統計、視覚化情報を設定する優先ヘッダー。

要求本文

名前	必須	型	説明
query	True	string	実行するクエリ。
timespan		string	任意データのクエリを実行する期間。これは、ISO8601期間の値です。この期間は、クエリ式で指定された期間に加えて適用されます。
workspaces		string[]	クエリに含まれるワークスペースの一覧。

応答

名前	型	説明
200 OK	queryResults	わかりました。 API 呼び出しが成功し、Analytics クエリの結果が応答ペイロードに含まれる
Other Status Codes	errorResponse	エラー応答オブジェクト。

セキュリティ

oauth2

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

cross-workspace

simple-query

cross-workspace

要求のサンプル

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

応答のサンプル

状態コード:: 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

要求のサンプル

HTTP

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

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

応答のサンプル

状態コード:: 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"
        ]
      ]
    }
  ]
}

定義

名前	説明
column	テーブル列。
errorDetail	エラーの詳細。
errorInfo	エラーのコードとメッセージ。
errorResponse	エラーの詳細。
logsColumnType	この列のデータ型。
queryBody	Analytics クエリ。 Analytics クエリ構文の詳細については、
queryResults	クエリ応答。
Render	JSON 形式の視覚化データ。
Statistics	JSON 形式で表される統計。
table	クエリ応答テーブル。

column

Object

テーブル列。

名前	型	説明
name	string	この列の名前。
type	logsColumnType	この列のデータ型。

errorDetail

Object

エラーの詳細。

名前	型	説明
additionalProperties	object	エラーの詳細オブジェクトに指定できる追加のプロパティ
code	string	エラーのコード。
message	string	人間が判読できるエラーメッセージ。
resources	string[]	エラーの原因となったリソースを示します。
target	string	要求のどのプロパティがエラーの原因であるかを示します。
value	string	エラーの原因となる 'target' の値を示します。

errorInfo

Object

エラーのコードとメッセージ。

名前	型	説明
additionalProperties	object	エラー情報オブジェクトに指定できる追加のプロパティ
code	string	コンピューターが読み取り可能なエラーコード。
details	errorDetail[]	エラーの詳細。
innererror	errorInfo	エラーのコードとメッセージ。内部エラーの詳細 (存在する場合)。
message	string	人間が判読できるエラーメッセージ。

errorResponse

Object

エラーの詳細。

名前	型	説明
error	errorInfo	エラーのコードとメッセージ。エラーの詳細。

logsColumnType

列挙

この列のデータ型。

値	説明
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryBody

Object

Analytics クエリ。 Analytics クエリ構文の詳細については、

名前	型	説明
query	string	実行するクエリ。
timespan	string	任意データのクエリを実行する期間。これは、ISO8601期間の値です。この期間は、クエリ式で指定された期間に加えて適用されます。
workspaces	string[]	クエリに含まれるワークスペースの一覧。

queryResults

Object

クエリ応答。

名前	型	説明
error	errorInfo	エラーのコードとメッセージ。
render	Render	JSON 形式の視覚化データ。
statistics	Statistics	JSON 形式で表される統計。
tables	table[]	テーブル、列、行の一覧。

Render

Object

JSON 形式の視覚化データ。

Statistics

Object

JSON 形式で表される統計。

table

Object

クエリ応答テーブル。

名前	型	説明
columns	column[]	このテーブル内の列の一覧。
name	string	テーブルの名前。
rows	object[]	このクエリの結果の行。

次の方法で共有

Query - Execute

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

oauth2

スコープ

例

cross-workspace

要求のサンプル

応答のサンプル

simple-query

要求のサンプル

応答のサンプル

定義

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryBody

queryResults

Render

Statistics

table