Tables - Create Or Update

Dienst:: Log Analytics

API-Version:: 2026-03-01

Aktualisieren oder Erstellen einer Log Analytics-Arbeitsbereichstabelle.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	Der Name der Tabelle.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Der Name des Arbeitsbereichs.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.plan	TablePlanEnum	Weisen Sie das System an, wie die protokolle verarbeitet und belastet werden, die in diese Tabelle aufgenommen wurden.
properties.protectionLevel	TableProtectionLevelEnum	Die Schutzstufe des Tisches. Bestimmt das Standardverhalten der Datenzugriffsisolation.
properties.restoredLogs	RestoredLogs	Parameter des Wiederherstellungsvorgangs, der diese Tabelle initiiert hat.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	In der Analytics-Tabelle: die Tabellen Analytics-Aufbewahrung in Tagen, zwischen 4 und 730. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig die Arbeitsbereichaufbewahrung verwendet. In der Basis- und Hilfstabelle: schreibgeschützte Eigenschaft.
properties.schema	Schema	Tabellenschema.
properties.searchResults	SearchResults	Parameter des Suchauftrags, der diese Tabelle initiiert hat.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Die Gesamtaufbewahrung der Tabelle in Tagen zwischen 4 und 4383. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig retentionInDays festgelegt.

Antworten

Name	Typ	Beschreibung
200 OK	Table	Die Aktualisierung der Ressource 'Tabelle' war erfolgreich
202 Accepted		Ressourcenvorgang akzeptiert. Header Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

Table

Die Aktualisierung der Ressource 'Tabelle' war erfolgreich

202 Accepted

Ressourcenvorgang akzeptiert.

Header

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Sich als Ihr Benutzerkonto ausgeben

Beispiele

TablesUpsert

Beispielanforderung

HTTP

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

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid"
        }
      ]
    },
    "retentionInDays": 45,
    "totalRetentionInDays": 70
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "AzureNetworkFlow",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow",
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid",
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "solutions": [
        "LogManagement"
      ],
      "standardColumns": [
        {
          "name": "TenantId",
          "type": "guid",
          "isDefaultDisplay": false,
          "isHidden": true
        },
        {
          "name": "SourceSystem",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TimeGenerated",
          "type": "dateTime",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "AgentID",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourceIP",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Protocol",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourcePort",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "DestinationPort",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TcpFlags",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Packets",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Bytes",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "BytesOut",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "DurationInMs",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "RstCount",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "MaxSampleRtt",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "Microsoft"
    },
    "archiveRetentionInDays": 25,
    "plan": "Analytics",
    "provisioningState": "Succeeded",
    "retentionInDays": 45,
    "retentionInDaysAsDefault": false,
    "totalRetentionInDays": 70,
    "totalRetentionInDaysAsDefault": false
  }
}

Statuscode:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperaitonalInsights/workspaces/oiautorest6685/tables/table1_CL/operationresults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01
azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.OperaitonalInsights/locations/eastus/operationstatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01

Definitionen

Name	Beschreibung
Column	Tabellenspalte.
ColumnDataTypeHintEnum	Logischer Hinweis für den Spaltendatentyp.
ColumnTypeEnum	Spaltendatentyp.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
OperationalInsightsTableProvisioningState	Der aktuelle Bereitstellungsstatus der Tabelle. Wenn sie auf "Aktualisieren" festgelegt ist, wird eine Ressourcensperre aufgrund des laufenden Vorgangs angezeigt, soweit alle Aktualisierungen der Tabelle bis zum Abschluss des laufenden Vorgangs aufgehoben werden.
RestoredLogs	Wiederherstellen von Parametern.
ResultStatistics	Suchauftragsausführungsstatistiken.
Schema	Schema der Tabelle.
SearchResults	Parameter des Suchauftrags, der diese Tabelle initiiert hat.
SourceEnum	Der Schöpfer des Tisches.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
Table	Definition der Arbeitsbereichsdatentabelle.
TablePlanEnum	Weisen Sie das System an, wie die protokolle verarbeitet und belastet werden, die in diese Tabelle aufgenommen wurden.
TableProtectionLevelEnum	Die Schutzstufe des Tisches. Bestimmt das Standardverhalten der Datenzugriffsisolation.
TableSubTypeEnum	Der Untertyp beschreibt, welche APIs für die Interaktion mit der Tabelle verwendet werden können und welche Funktionen für die Tabelle verfügbar sind.
TableTypeEnum	Der Schöpfer des Tisches.

Column

Objekt

Tabellenspalte.

Name	Typ	Beschreibung
dataTypeHint	ColumnDataTypeHintEnum	Logischer Hinweis für den Spaltendatentyp.
description	string	Spaltenbeschreibung.
displayName	string	Anzeigename der Spalte. Kann zur Erstellung eingestellt werden; Nach der Erstellung müssen Updates entweder den Spaltennamen übereinstimmen oder auf null/leer setzen. Wenn nicht angegeben, verwendet er standardmäßig den Spaltennamen.
isDefaultDisplay	boolean	Wird standardmäßig angezeigt.
isHidden	boolean	Ist spalte ausgeblendet.
name	string	Spaltenname.
type	ColumnTypeEnum	Spaltendatentyp.

ColumnDataTypeHintEnum

Enumeration

Logischer Hinweis für den Spaltendatentyp.

Wert	Beschreibung
uri	Eine Zeichenfolge, die dem Muster eines URI entspricht, z. B. scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment
guid	Eine Standardmäßige 128-Bit-GUID nach dem Standard-Shape xx-xxxx-xxxx-xxxx-xx
armPath	Ein Azure Resource Model (ARM)-Pfad: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
ip	Eine standardmäßige V4/V6-IP-Adresse nach dem Standard-Shape x.x.x/y:y:y:y:y:y:y:y:y:y:y
vector16	Ein Vektor von Gleitkommawerten mit einer einzigen Präzision, der für die semantische / Ähnlichkeitssuche verwendet wird.

ColumnTypeEnum

Enumeration

Spaltendatentyp.

Wert	Beschreibung
string	string
int	int
long	long
real	real
boolean	Boolean
dateTime	Datum und Uhrzeit
guid	guid
dynamic	dynamisch

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der Zusatzinformationen.

ErrorDetail

Objekt

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die Zusatzinformationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Der Fehlerzielwert.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

OperationalInsightsTableProvisioningState

Enumeration

Der aktuelle Bereitstellungsstatus der Tabelle. Wenn sie auf "Aktualisieren" festgelegt ist, wird eine Ressourcensperre aufgrund des laufenden Vorgangs angezeigt, soweit alle Aktualisierungen der Tabelle bis zum Abschluss des laufenden Vorgangs aufgehoben werden.

Wert	Beschreibung
Updating	Das Tabellenschema wird noch erstellt und aktualisiert, tabelle ist derzeit für alle Änderungen gesperrt, bis die Prozedur abgeschlossen ist.
InProgress	Das Tabellenschema ist stabil und ohne Änderungen werden die Tabellendaten aktualisiert.
Succeeded	Der Tabellenzustand ist stabil und ohne Änderungen ist die Tabelle entsperrt und für neue Updates geöffnet.
Deleting	Der Tabellenstatus wird gelöscht.

RestoredLogs

Objekt

Wiederherstellen von Parametern.

Name	Typ	Beschreibung
azureAsyncOperationId	string	Asynchrone Vorgangs-ID in der Tabelle der Suchergebnisse.
endRestoreTime	string (date-time)	Der Zeitstempel, um die Wiederherstellung um (UTC) zu beenden.
sourceTable	string	Die Tabelle, aus der Daten wiederhergestellt werden sollen.
startRestoreTime	string (date-time)	Der Zeitstempel zum Starten der Wiederherstellung von (UTC).

ResultStatistics

Objekt

Suchauftragsausführungsstatistiken.

Name	Typ	Beschreibung
ingestedRecords	integer (int32)	Die Anzahl der Zeilen, die vom Suchauftrag zurückgegeben wurden.
progress	number (float)	Prozentsatz der Auftragsabschlusssuche.
scannedGb	number (float)	Suchauftrag: Die Menge der gescannten Daten.

Schema

Objekt

Schema der Tabelle.

Name	Typ	Beschreibung
categories	string[]	Tabellenkategorie.
columns	Column[]	Eine Liste der benutzerdefinierten Tabellenspalten.
description	string	Tabellenbeschreibung.
displayName	string	Anzeigename der Tabelle.
labels	string[]	Tabellenbeschriftungen.
name	string	Tabellenname.
solutions	string[]	Liste der Lösungen, mit denen die Tabelle verknüpft ist
source	SourceEnum	Der Schöpfer des Tisches.
standardColumns	Column[]	Eine Liste der Tabellenstandardspalten.
tableSubType	TableSubTypeEnum	Der Untertyp beschreibt, welche APIs für die Interaktion mit der Tabelle verwendet werden können und welche Funktionen für die Tabelle verfügbar sind.
tableType	TableTypeEnum	Der Schöpfer des Tisches.

SearchResults

Objekt

Parameter des Suchauftrags, der diese Tabelle initiiert hat.

Name	Typ	Beschreibung
azureAsyncOperationId	string	Asynchrone Vorgangs-ID in der Tabelle der Suchergebnisse.
description	string	Suchauftragsbeschreibung.
endSearchTime	string (date-time)	Der Zeitstempel zum Beenden der Suche nach (UTC)
limit	integer (int32)	Beschränken Sie den Suchauftrag so, dass er bis zur angegebenen Anzahl von Zeilen zurückgibt.
query	string	Suchauftragsabfrage.
sourceTable	string	Die Tabelle, die im Suchauftrag verwendet wird.
startSearchTime	string (date-time)	Der Zeitstempel zum Starten der Suche von (UTC)

SourceEnum

Enumeration

Der Schöpfer des Tisches.

Wert	Beschreibung
microsoft	Vom System bereitgestellte Tabellen, die über Diagnoseeinstellungen, die Agents oder andere Standarddatensammlungen erfasst werden.
customer	Tabellen, die vom Besitzer des Arbeitsbereichs erstellt wurden und nur in diesem Arbeitsbereich gefunden wurden.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Table

Objekt

Definition der Arbeitsbereichsdatentabelle.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.archiveRetentionInDays	integer (int32)	Die Tabellen für die langfristige Aufbewahrung in Tagen. Berechnet als (totalRetentionInDays-retentionInDays).
properties.lastPlanModifiedDate	string	Der Zeitstempel, den der Tabellenplan zuletzt geändert hat (UTC).
properties.plan	TablePlanEnum	Weisen Sie das System an, wie die protokolle verarbeitet und belastet werden, die in diese Tabelle aufgenommen wurden.
properties.protectionLevel	TableProtectionLevelEnum	Die Schutzstufe des Tisches. Bestimmt das Standardverhalten der Datenzugriffsisolation.
properties.provisioningState	OperationalInsightsTableProvisioningState	Der aktuelle Bereitstellungsstatus der Tabelle. Wenn sie auf "Aktualisieren" festgelegt ist, wird eine Ressourcensperre aufgrund des laufenden Vorgangs angezeigt, soweit alle Aktualisierungen der Tabelle bis zum Abschluss des laufenden Vorgangs aufgehoben werden.
properties.restoredLogs	RestoredLogs	Parameter des Wiederherstellungsvorgangs, der diese Tabelle initiiert hat.
properties.resultStatistics	ResultStatistics	Suchauftragsausführungsstatistiken.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	In der Analytics-Tabelle: die Tabellen Analytics-Aufbewahrung in Tagen, zwischen 4 und 730. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig die Arbeitsbereichaufbewahrung verwendet. In der Basis- und Hilfstabelle: schreibgeschützte Eigenschaft.
properties.retentionInDaysAsDefault	boolean	True – Wert stammt aus der Arbeitsbereichsaufbewahrung in Tagen, False - Kundenspezifisch.
properties.schema	Schema	Tabellenschema.
properties.searchResults	SearchResults	Parameter des Suchauftrags, der diese Tabelle initiiert hat.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Die Gesamtaufbewahrung der Tabelle in Tagen zwischen 4 und 4383. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig retentionInDays festgelegt.
properties.totalRetentionInDaysAsDefault	boolean	True - Wert stammt aus der Aufbewahrung in Tagen, False - Kundenspezifisch.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

TablePlanEnum

Enumeration

Weisen Sie das System an, wie die protokolle verarbeitet und belastet werden, die in diese Tabelle aufgenommen wurden.

Wert	Beschreibung
Basic	Medium-Touch-Protokolle, die für die Fehlerbehebung und die Reaktion auf Vorfälle erforderlich sind.
Analytics	Hochwertige Protokolle, die für die kontinuierliche Überwachung, Echtzeiterkennung und Leistungsanalyse verwendet werden.
Auxiliary	Low-Touch-Protokolle, z. B. ausführliche Protokolle, und Daten, die für Überwachung und Compliance erforderlich sind.

TableProtectionLevelEnum

Enumeration

Die Schutzstufe des Tisches. Bestimmt das Standardverhalten der Datenzugriffsisolation.

Wert	Beschreibung
General	Das Standard-Schutzniveau. Tabellendaten sind über Standardberechtigungen zugänglich.
Protected	Tabellendaten sind standardmäßig isoliert. Der Zugriff auf oder der Export von Daten erfordert eine explizite, begrenzte Autorisierung.

TableSubTypeEnum

Enumeration

Der Untertyp beschreibt, welche APIs für die Interaktion mit der Tabelle verwendet werden können und welche Funktionen für die Tabelle verfügbar sind.

Wert	Beschreibung
Any	Der Standarduntertyp, mit dem integrierte Tabellen erstellt werden.
Classic	Gibt eine Tabelle an, die über die Datensammler-API oder mit der benutzerdefinierten Protokollfunktion des MMA-Agents oder einer Beliebigen Tabelle erstellt wurde, für die benutzerdefinierte Felder erstellt wurden.
DataCollectionRuleBased	Eine Tabelle, die berechtigt ist, Daten über eine der von Datensammlungsregeln unterstützten Mittel an sie zu senden: die Datensammlungsendpunkt-API, Aufnahmezeittransformationen oder einen anderen Mechanismus, der von Datensammlungsregeln bereitgestellt wird

TableTypeEnum

Enumeration

Der Schöpfer des Tisches.

Wert	Beschreibung
Microsoft	Von Azure Monitor gesammelte Standarddaten.
CustomLog	Benutzerdefinierte Protokolltabelle.
RestoredLogs	Daten wiederhergestellt.
SearchResults	Von einem Suchauftrag gesammelte Daten.