Tables - Get
Log Analytics ワークスペース テーブルを取得します。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2025-07-01
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
リソース グループの名前。 名前は大文字と小文字が区別されます。 |
|
subscription
|
path | True |
string minLength: 1 |
ターゲット サブスクリプションの ID。 |
|
table
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9-_]+$ |
テーブルの名前。 |
|
workspace
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
ワークスペースの名前。 |
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
OK 応答定義。 |
|
| Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| user_impersonation | ユーザー アカウントを偽装する |
例
TablesGet
要求のサンプル
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH?api-version=2025-07-01
応答のサンプル
{
"systemData": {
"createdBy": "00000000-0000-0000-0000-00000000000",
"createdAt": "2020-02-03T04:05:06Z"
},
"properties": {
"resultStatistics": {
"progress": 75,
"ingestedRecords": 5,
"scannedGb": 23.5
},
"searchResults": {
"query": "Heartbeat | where SourceSystem != '' | project SourceSystem",
"description": "This table was created using a Search Job with the following query: 'Heartbeat | where SourceSystem != '' | project SourceSystem'.",
"limit": 1000,
"startSearchTime": "2020-02-03T04:05:06Z",
"endSearchTime": "2020-02-02T04:05:06Z",
"sourceTable": "Heartbeat"
},
"schema": {
"name": "table1_SRCH",
"tableSubType": "DataCollectionRuleBased",
"tableType": "SearchResults",
"displayName": null,
"description": null,
"columns": [],
"standardColumns": [
{
"isHidden": false,
"name": "TenantId",
"type": "guid",
"dataTypeHint": null,
"displayName": null,
"description": null,
"isDefaultDisplay": false
},
{
"isHidden": false,
"name": "SourceSystem",
"type": "string",
"dataTypeHint": null,
"displayName": null,
"description": null,
"isDefaultDisplay": false
},
{
"isHidden": false,
"name": "MG",
"type": "guid",
"dataTypeHint": null,
"displayName": null,
"description": null,
"isDefaultDisplay": false
},
{
"isHidden": false,
"name": "ManagementGroupName",
"type": "string",
"dataTypeHint": null,
"displayName": null,
"description": null,
"isDefaultDisplay": false
},
{
"isHidden": false,
"name": "TimeGenerated",
"type": "dateTime",
"dataTypeHint": null,
"displayName": null,
"description": null,
"isDefaultDisplay": false
},
{
"isHidden": false,
"name": "Computer",
"type": "string",
"dataTypeHint": null,
"displayName": null,
"description": null,
"isDefaultDisplay": false
},
{
"isHidden": false,
"name": "RawData",
"type": "string",
"dataTypeHint": null,
"displayName": null,
"description": null,
"isDefaultDisplay": false
}
],
"categories": null,
"labels": null,
"source": null,
"solutions": [
"LogManagement"
]
},
"provisioningState": "InProgress",
"retentionInDays": 50,
"totalRetentionInDays": 50,
"archiveRetentionInDays": 0,
"retentionInDaysAsDefault": false,
"totalRetentionInDaysAsDefault": true,
"plan": "Analytics"
},
"id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH",
"name": "table1_SRCH"
}
定義
| 名前 | 説明 |
|---|---|
| Column |
テーブル列。 |
|
Column |
列データ型の論理ヒント。 |
|
Column |
列データ型。 |
|
created |
リソースを作成した ID の種類。 |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Provisioning |
テーブルの現在のプロビジョニング状態。 'updating' に設定すると、進行中の操作によるリソースロックを示し、進行中の操作が終了するまでテーブルへの更新が禁止されます。 |
|
Restored |
パラメータを復元します。 |
|
Result |
ジョブ実行統計を検索します。 |
| Schema |
テーブルのスキーマ。 |
|
Search |
このテーブルを開始した検索ジョブのパラメーター。 |
|
Source |
テーブルの作成者。 |
|
system |
リソースの作成と最後の変更に関連するメタデータ。 |
| Table |
ワークスペースデータテーブル定義。 |
|
Table |
このテーブルに取り込まれたログを処理して課金する方法をシステムに指示します。 |
|
Table |
サブタイプは、テーブルとの対話に使用できる API と、テーブルに対して使用できる機能を記述します。 |
|
Table |
テーブルの作成者。 |
Column
テーブル列。
| 名前 | 型 | 説明 |
|---|---|---|
| dataTypeHint |
列データ型の論理ヒント。 |
|
| description |
string |
列の説明。 |
| displayName |
string |
列の表示名。 |
| isDefaultDisplay |
boolean |
デフォルトで表示されます。 |
| isHidden |
boolean |
列が非表示になっています。 |
| name |
string |
列名。 |
| type |
列データ型。 |
ColumnDataTypeHintEnum
列データ型の論理ヒント。
| 値 | 説明 |
|---|---|
| uri |
URI のパターンに一致する文字列 (例: scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment |
| guid |
標準図形 xxxxxxxx-xxxx-xxxx-xxxx-xxxx に従った標準の 128 ビット GUID |
| armPath |
Azure リソース モデル (ARM) パス: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft です。{...}/{...}/{...}/{...}... |
| ip |
標準形状 x.x.x.x/y:y:y:y に従った標準 V4/V6 IP アドレス |
ColumnTypeEnum
列データ型。
| 値 | 説明 |
|---|---|
| string | |
| int | |
| long | |
| real | |
| boolean | |
| dateTime | |
| guid | |
| dynamic |
createdByType
リソースを作成した ID の種類。
| 値 | 説明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| 名前 | 型 | 説明 |
|---|---|---|
| info |
object |
追加情報。 |
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細です。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
ProvisioningStateEnum
テーブルの現在のプロビジョニング状態。 'updating' に設定すると、進行中の操作によるリソースロックを示し、進行中の操作が終了するまでテーブルへの更新が禁止されます。
| 値 | 説明 |
|---|---|
| Updating |
テーブルスキーマはまだ構築および更新中であり、プロシージャが完了するまで、テーブルは現在変更に対してロックされています。 |
| InProgress |
テーブルスキーマは安定しており、変更なしでテーブルデータは更新されています。 |
| Succeeded |
テーブルの状態は安定しており、変更がなければ、テーブルのロックが解除され、新しい更新のために開かれます。 |
| Deleting |
テーブルの状態は削除中です。 |
RestoredLogs
パラメータを復元します。
| 名前 | 型 | 説明 |
|---|---|---|
| azureAsyncOperationId |
string |
検索結果テーブルの非同期操作 ID。 |
| endRestoreTime |
string (date-time) |
復元を終了するタイムスタンプ (UTC)。 |
| sourceTable |
string |
データの復元元のテーブル。 |
| startRestoreTime |
string (date-time) |
復元を開始するタイムスタンプ (UTC)。 |
ResultStatistics
ジョブ実行統計を検索します。
| 名前 | 型 | 説明 |
|---|---|---|
| ingestedRecords |
integer (int32) |
検索ジョブによって返された行の数。 |
| progress |
number multipleOf: 0.01 |
ジョブの完了率を検索します。 |
| scannedGb |
number multipleOf: 0.01 |
検索ジョブ: スキャンされたデータの量。 |
Schema
テーブルのスキーマ。
| 名前 | 型 | 説明 |
|---|---|---|
| categories |
string[] |
テーブルカテゴリ。 |
| columns |
Column[] |
テーブルのカスタム列の一覧。 |
| description |
string |
テーブルの説明。 |
| displayName |
string |
テーブルの表示名。 |
| labels |
string[] |
テーブルラベル。 |
| name |
string |
テーブル名。 |
| solutions |
string[] |
テーブルが関連付けられているソリューションのリスト |
| source |
テーブルの作成者。 |
|
| standardColumns |
Column[] |
テーブル標準列のリスト。 |
| tableSubType |
サブタイプは、テーブルとの対話に使用できる API と、テーブルに対して使用できる機能を記述します。 |
|
| tableType |
テーブルの作成者。 |
SearchResults
このテーブルを開始した検索ジョブのパラメーター。
| 名前 | 型 | 説明 |
|---|---|---|
| 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
リソースの作成と最後の変更に関連するメタデータ。
| 名前 | 型 | 説明 |
|---|---|---|
| createdAt |
string (date-time) |
リソース作成のタイムスタンプ (UTC)。 |
| createdBy |
string |
リソースを作成した ID。 |
| createdByType |
リソースを作成した ID の種類。 |
|
| lastModifiedAt |
string (date-time) |
リソースの最終変更のタイムスタンプ (UTC) |
| lastModifiedBy |
string |
リソースを最後に変更した ID。 |
| lastModifiedByType |
リソースを最後に変更した ID の種類。 |
Table
ワークスペースデータテーブル定義。
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string |
リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
リソースの名前 |
| properties.archiveRetentionInDays |
integer (int32) |
表は、日数単位の長期保持期間です。 (totalRetentionInDays-retentionInDays) として計算されます。 |
| properties.lastPlanModifiedDate |
string |
テーブルプランが最終変更されたタイムスタンプ (UTC)。 |
| properties.plan |
このテーブルに取り込まれたログを処理して課金する方法をシステムに指示します。 |
|
| properties.provisioningState |
テーブルの現在のプロビジョニング状態。 'updating' に設定すると、進行中の操作によるリソースロックを示し、進行中の操作が終了するまでテーブルへの更新が禁止されます。 |
|
| properties.restoredLogs |
このテーブルを開始した復元操作のパラメーター。 |
|
| properties.resultStatistics |
ジョブ実行統計を検索します。 |
|
| properties.retentionInDays |
integer (int32) minimum: 4maximum: 730 |
分析テーブル: テーブルには、4 から 730 までの分析保持期間が日数表示されます。 このプロパティを -1 に設定すると、既定でワークスペースの保持期間が設定されます。 基本テーブルと補助テーブル: 読み取り専用プロパティ。 |
| properties.retentionInDaysAsDefault |
boolean |
True - 値はワークスペースの保持期間 (日数) から取得され、False - 顧客固有です。 |
| properties.schema |
テーブル スキーマ。 |
|
| properties.searchResults |
このテーブルを開始した検索ジョブのパラメーター。 |
|
| properties.totalRetentionInDays |
integer (int32) minimum: 4maximum: 4383 |
テーブルの合計リテンション期間 (4 ~ 4383 日)。 このプロパティを -1 に設定すると、既定で retentionInDays になります。 |
| properties.totalRetentionInDaysAsDefault |
boolean |
True - 値は日数単位の保持から取得され、False - 顧客固有。 |
| systemData |
リソースの作成と最後の変更に関連するメタデータ。 |
|
| type |
string |
リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
TablePlanEnum
このテーブルに取り込まれたログを処理して課金する方法をシステムに指示します。
| 値 | 説明 |
|---|---|
| Basic |
トラブルシューティングとインシデント対応に必要なミディアムタッチログ。 |
| Analytics |
継続的な監視、リアルタイム検出、パフォーマンス分析に使用される価値の高いログ。 |
| Auxiliary |
詳細ログなどのロータッチログ、および監査とコンプライアンスに必要なデータ。 |
TableSubTypeEnum
サブタイプは、テーブルとの対話に使用できる API と、テーブルに対して使用できる機能を記述します。
| 値 | 説明 |
|---|---|
| Any |
組み込みテーブルの作成に使用するデフォルトのサブタイプ。 |
| Classic |
Data Collector API または MMA エージェントのカスタムログ機能を使用して作成されたテーブル、またはカスタムフィールドが作成されたテーブルを示します。 |
| DataCollectionRuleBased |
データ収集ルールでサポートされている手段(データ収集エンドポイント API、取り込み時変換、またはデータ収集ルールによって提供されるその他のメカニズム)を介してデータを送信する資格のあるテーブル |
TableTypeEnum
テーブルの作成者。
| 値 | 説明 |
|---|---|
| Microsoft |
Azure Monitor によって収集される標準データ。 |
| CustomLog |
カスタムログテーブル。 |
| RestoredLogs |
復元されたデータ。 |
| SearchResults |
検索ジョブによって収集されるデータ。 |