Tables - Get

サービス:

Log Analytics

API バージョン:

2026-03-01

Log Analytics ワークスペース テーブルを取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2026-03-01

URI パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソース グループの名前。 名前は大文字と小文字を区別しません。
subscriptionId	path	True	string (uuid)	ターゲット サブスクリプションの ID。 値は UUID である必要があります。
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	テーブルの名前。
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	ワークスペースの名前。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	Table	Azureの運用は無事に完了しました。
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

スコープ

名前	説明
user_impersonation	あなたのユーザー アカウントになりすます

例

TablesGet

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH?api-version=2026-03-01

応答のサンプル

状態コード:

200

{
  "name": "table1_SRCH",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH",
  "properties": {
    "schema": {
      "name": "table1_SRCH",
      "description": null,
      "categories": null,
      "columns": [],
      "displayName": null,
      "labels": null,
      "solutions": [
        "LogManagement"
      ],
      "source": null,
      "standardColumns": [
        {
          "name": "TenantId",
          "type": "guid",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourceSystem",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "MG",
          "type": "guid",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "ManagementGroupName",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TimeGenerated",
          "type": "dateTime",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Computer",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "RawData",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "SearchResults"
    },
    "archiveRetentionInDays": 0,
    "plan": "Analytics",
    "provisioningState": "InProgress",
    "resultStatistics": {
      "ingestedRecords": 5,
      "progress": 75,
      "scannedGb": 23.5
    },
    "retentionInDays": 50,
    "retentionInDaysAsDefault": false,
    "searchResults": {
      "description": "This table was created using a Search Job with the following query: 'Heartbeat | where SourceSystem != '' | project SourceSystem'.",
      "endSearchTime": "2020-02-02T04:05:06Z",
      "limit": 1000,
      "query": "Heartbeat | where SourceSystem != '' | project SourceSystem",
      "sourceTable": "Heartbeat",
      "startSearchTime": "2020-02-03T04:05:06Z"
    },
    "totalRetentionInDays": 50,
    "totalRetentionInDaysAsDefault": true
  },
  "systemData": {
    "createdAt": "2020-02-03T04:05:06Z",
    "createdBy": "00000000-0000-0000-0000-000000000000"
  }
}

定義

名前	説明
Column	テーブル列。
ColumnDataTypeHintEnum	列データ型の論理ヒント。
ColumnTypeEnum	列データ型。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
OperationalInsightsTableProvisioningState	テーブルの現在のプロビジョニング状態。 "更新中" に設定されている場合は、進行中の操作によるリソース ロックを示し、進行中の操作が終了するまでテーブルへの更新を禁止します。
RestoredLogs	復元パラメーター。
ResultStatistics	ジョブ実行統計を検索します。
Schema	テーブルのスキーマ。
SearchResults	このテーブルを開始した検索ジョブのパラメーター。
SourceEnum	テーブルの作成者。
systemData	リソースの作成と最後の変更に関連するメタデータ。
Table	ワークスペース データ テーブルの定義。
TablePlanEnum	このテーブルに取り込まれたログを処理して課金する方法をシステムに指示します。
TableProtectionLevelEnum	テーブルの保護レベル。 デフォルトのデータアクセス隔離動作を決定します。
TableSubTypeEnum	サブタイプは、テーブルとの対話に使用できる API と、テーブルに対して使用できる機能を記述します。
TableTypeEnum	テーブルの作成者。

Column

Object

テーブル列。

名前	型	説明
dataTypeHint	ColumnDataTypeHintEnum	列データ型の論理ヒント。
description	string	列の説明。
displayName	string	列の表示名。 作成時に設定可能です。作成後、更新は列名と一致するか、null/emptyに設定する必要があります。 提供されない場合は、カラム名がデフォルトになります。
isDefaultDisplay	boolean	既定で表示されます。
isHidden	boolean	列が非表示です。
name	string	列名。
type	ColumnTypeEnum	列データ型。

ColumnDataTypeHintEnum

列挙

列データ型の論理ヒント。

値	説明
uri	URI のパターンに一致する文字列 (例: k2=v2#fragment scheme://username:password@host:1234/this/is/a/path?k1=v1&)
guid	標準図形に続く標準の 128 ビット GUID、xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
armPath	Azure リソース モデル (ARM) パス: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft。{...}/{...}/{...}/{...}...
ip	標準図形 x.x.x.x/y:y:y:y:y:y:y:y:y:y:y に続く標準 V4/V6 IP アドレス
vector16	意味論的/類似性探索に使われる単精度浮動小数点値のベクトル。

ColumnTypeEnum

列挙

列データ型。

値	説明
string	文字列
int	int
long	long
real	real
boolean	boolean
dateTime	dateTime
guid	guid
dynamic	dynamic

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーに関する追加情報。
code	string	エラー コード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラー メッセージ。
target	string	エラーの対象。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラー オブジェクト。

OperationalInsightsTableProvisioningState

列挙

テーブルの現在のプロビジョニング状態。 "更新中" に設定されている場合は、進行中の操作によるリソース ロックを示し、進行中の操作が終了するまでテーブルへの更新を禁止します。

値	説明
Updating	テーブル スキーマは引き続きビルドおよび更新中です。現在、プロシージャが完了するまで、テーブルは変更に対してロックされています。
InProgress	テーブルスキーマは安定しており、変更なしでテーブルデータは更新されています。
Succeeded	テーブルの状態は安定しており、変更なしで、テーブルはロック解除され、新しい更新のために開きます。
Deleting	テーブルの状態は削除中です。

RestoredLogs

Object

復元パラメーター。

名前	型	説明
azureAsyncOperationId	string	検索結果テーブルの非同期操作 ID。
endRestoreTime	string (date-time)	復元を終了するタイムスタンプ (UTC)。
sourceTable	string	データの復元元のテーブル。
startRestoreTime	string (date-time)	復元を開始するタイムスタンプ (UTC)。

ResultStatistics

Object

ジョブ実行統計を検索します。

名前	型	説明
ingestedRecords	integer (int32)	検索ジョブによって返された行の数。
progress	number (float)	検索ジョブの完了率。
scannedGb	number (float)	検索ジョブ: スキャンされたデータの量。

Schema

Object

テーブルのスキーマ。

名前	型	説明
categories	string[]	テーブル カテゴリ。
columns	Column[]	テーブルのカスタム列の一覧。
description	string	テーブルの説明。
displayName	string	テーブルの表示名。
labels	string[]	テーブル ラベル。
name	string	テーブル名。
solutions	string[]	テーブルが関連付けられているソリューションのリスト
source	SourceEnum	テーブルの作成者。
standardColumns	Column[]	テーブルの標準列の一覧。
tableSubType	TableSubTypeEnum	サブタイプは、テーブルとの対話に使用できる API と、テーブルに対して使用できる機能を記述します。
tableType	TableTypeEnum	テーブルの作成者。

SearchResults

Object

このテーブルを開始した検索ジョブのパラメーター。

名前	型	説明
azureAsyncOperationId	string	検索結果テーブルの非同期操作 ID。
description	string	検索ジョブの説明。
endSearchTime	string (date-time)	検索を終了するタイムスタンプ (UTC)
limit	integer (int32)	指定した行数まで検索ジョブを返すように制限します。
query	string	ジョブ クエリを検索します。
sourceTable	string	検索ジョブで使用されるテーブル。
startSearchTime	string (date-time)	検索を開始するタイムスタンプ (UTC)

SourceEnum

列挙

テーブルの作成者。

値	説明
microsoft	診断設定、エージェント、またはその他の標準データ収集手段を使用して収集された、システムによってプロビジョニングされたテーブル。
customer	ワークスペースの所有者によって作成され、このワークスペースでのみ見つかったテーブル。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

Table

Object

ワークスペース データ テーブルの定義。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.archiveRetentionInDays	integer (int32)	表は、日数単位の長期保持期間です。 (totalRetentionInDays-retentionInDays) として計算されます。
properties.lastPlanModifiedDate	string	テーブル プランが最後に変更されたタイムスタンプ (UTC)。
properties.plan	TablePlanEnum	このテーブルに取り込まれたログを処理して課金する方法をシステムに指示します。
properties.protectionLevel	TableProtectionLevelEnum	テーブルの保護レベル。 デフォルトのデータアクセス隔離動作を決定します。
properties.provisioningState	OperationalInsightsTableProvisioningState	テーブルの現在のプロビジョニング状態。 "更新中" に設定されている場合は、進行中の操作によるリソース ロックを示し、進行中の操作が終了するまでテーブルへの更新を禁止します。
properties.restoredLogs	RestoredLogs	このテーブルを開始した復元操作のパラメーター。
properties.resultStatistics	ResultStatistics	ジョブ実行統計を検索します。
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	分析テーブル: テーブルには、4 から 730 までの分析保持期間が日数表示されます。 このプロパティを -1 に設定すると、既定でワークスペースの保持期間が設定されます。 基本テーブルと補助テーブル: 読み取り専用プロパティ。
properties.retentionInDaysAsDefault	boolean	True - 値はワークスペースのリテンション期間 (日数)、False - 顧客固有に由来します。
properties.schema	Schema	テーブル スキーマ。
properties.searchResults	SearchResults	このテーブルを開始した検索ジョブのパラメーター。
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	テーブルの合計リテンション期間 (4 ~ 4383 日)。 このプロパティを -1 に設定すると、既定で retentionInDays になります。
properties.totalRetentionInDaysAsDefault	boolean	True - 値は日単位の保持に由来し、False - 顧客固有です。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの種類。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

TablePlanEnum

列挙

このテーブルに取り込まれたログを処理して課金する方法をシステムに指示します。

値	説明
Basic	トラブルシューティングとインシデント対応に必要なミディアムタッチログ。
Analytics	継続的な監視、リアルタイム検出、パフォーマンス分析に使用される価値の高いログ。
Auxiliary	詳細ログなどのロータッチログ、および監査とコンプライアンスに必要なデータ。

TableProtectionLevelEnum

列挙

テーブルの保護レベル。 デフォルトのデータアクセス隔離動作を決定します。

値	説明
General	デフォルトの保護レベル。 テーブルデータは標準の権限を通じてアクセス可能です。
Protected	テーブルデータはデフォルトで隔離されています。 データへのアクセスやエクスポートには、明示的かつ範囲限定の認可が必要です。

TableSubTypeEnum

列挙

サブタイプは、テーブルとの対話に使用できる API と、テーブルに対して使用できる機能を記述します。

値	説明
Any	組み込みテーブルが作成される既定のサブタイプ。
Classic	データ コレクター API または MMA エージェントのカスタム ログ機能を使用して作成されたテーブル、またはユーザー設定フィールドが作成されたテーブルを示します。
DataCollectionRuleBased	データ収集ルールでサポートされる手段 (データ収集エンドポイント API、インジェスト時変換、またはデータ収集ルールによって提供されるその他のメカニズム) を介してデータを送信できるテーブル

TableTypeEnum

列挙

テーブルの作成者。

値	説明
Microsoft	Azure Monitor によって収集された標準データ。
CustomLog	カスタム ログ テーブル。
RestoredLogs	復元されたデータ。
SearchResults	検索ジョブによって収集されたデータ。