Tables - Create Or Update

Referenz

Dienst:: Log Analytics

API-Version:: 2025-02-01

Dient zum 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=2025-02-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 minLength: 1	Die ID des Zielabonnements.
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.restoredLogs	RestoredLogs	Parameter des Wiederherstellungsvorgangs, der diese Tabelle initiiert hat.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Die Tabellenaufbewahrung in Tagen zwischen 4 und 730. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig die Arbeitsbereichaufbewahrung verwendet.
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 die Tabellenaufbewahrung verwendet.

Antworten

Name	Typ	Beschreibung
200 OK	Table	OK-Antwortdefinition.
202 Accepted		Akzeptierte Antwortdefinition (Lange ausgeführter Vorgang).
Other Status Codes	ErrorResponse	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

TablesUpsert

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "Microsoft",
      "columns": [
        {
          "isHidden": false,
          "name": "MyNewColumn",
          "type": "guid",
          "isDefaultDisplay": false
        }
      ],
      "standardColumns": [
        {
          "isHidden": true,
          "name": "TenantId",
          "type": "guid",
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "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
        }
      ],
      "solutions": [
        "LogManagement"
      ]
    },
    "provisioningState": "Succeeded",
    "retentionInDays": 45,
    "totalRetentionInDays": 70,
    "archiveRetentionInDays": 25,
    "retentionInDaysAsDefault": false,
    "totalRetentionInDaysAsDefault": false,
    "plan": "Analytics"
  },
  "id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow",
  "name": "AzureNetworkFlow"
}

Statuscode:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/providers/Microsoft.OperaitonalInsights/locations/eastus/operationstatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2025-02-01
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperaitonalInsights/workspaces/oiautorest6685/tables/table1_CL/operationresults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2025-02-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	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ProvisioningStateEnum	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	Ersteller der Tabelle.
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.
TableSubTypeEnum	Der Untertyp beschreibt, welche APIs für die Interaktion mit der Tabelle verwendet werden können und welche Features dafür verfügbar sind.
TableTypeEnum	Ersteller der Tabelle.

Column

Objekt

Tabellenspalte.

Name	Typ	Beschreibung
dataTypeHint	ColumnDataTypeHintEnum	Logischer Hinweis für den Spaltendatentyp.
description	string	Spaltenbeschreibung.
displayName	string	Anzeigename der Spalte.
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
armPath	Ein Azure Resource Model (ARM)-Pfad: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	Eine Standardmäßige 128-Bit-GUID nach dem Standard-Shape xx-xxxx-xxxx-xxxx-xx
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
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

ColumnTypeEnum

Enumeration

Spaltendatentyp.

Wert	Beschreibung
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ProvisioningStateEnum

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

RestoredLogs

Objekt

Wiederherstellen von Parametern.

Name	Typ	Beschreibung
azureAsyncOperationId	string	Asynchrone Suchergebnistabellen-Vorgangs-ID.
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 multipleOf: 0.01	Prozentsatz der Auftragsabschlusssuche.
scannedGb	number multipleOf: 0.01	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 der die Tabelle verbunden ist
source	SourceEnum	Ersteller der Tabelle.
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 Features dafür verfügbar sind.
tableType	TableTypeEnum	Ersteller der Tabelle.

SearchResults

Objekt

Parameter des Suchauftrags, der diese Tabelle initiiert hat.

Name	Typ	Beschreibung
azureAsyncOperationId	string	Asynchrone Suchergebnistabellen-Vorgangs-ID.
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

Ersteller der Tabelle.

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

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	Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.archiveRetentionInDays	integer (int32)	Die Aufbewahrung von Tabellendatenarchiven 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.provisioningState	ProvisioningStateEnum	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	Die Tabellenaufbewahrung in Tagen zwischen 4 und 730. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig die Arbeitsbereichaufbewahrung verwendet.
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 die Tabellenaufbewahrung verwendet.
properties.totalRetentionInDaysAsDefault	boolean	True - Wert stammt aus der Aufbewahrung in Tagen, False - Kundenspezifisch.
systemData	systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
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
Analytics	Protokolliert, die Überwachung und Analyse zulassen.
Basic	Protokolle, die angepasst werden, um ausführliche Ausführliche Protokolle mit hohem Volumen zu unterstützen.

TableSubTypeEnum

Enumeration

Der Untertyp beschreibt, welche APIs für die Interaktion mit der Tabelle verwendet werden können und welche Features dafür 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

Ersteller der Tabelle.

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

Freigeben über

Tables - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

TablesUpsert

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum

Zusätzliche Ressourcen