Tables - Create Or Update

Referenz

Dienst:: Log Analytics

API-Version:: 2023-09-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=2023-09-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
tableName	path	True	string	Der Name der Tabelle. RegEx-Muster: `^[A-Za-z0-9-_]+$`
workspaceName	path	True	string	Den Namen des Arbeitsbereichs RegEx-Muster: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
properties.plan	TablePlanEnum	Weisen Sie das System an, wie die in dieser Tabelle erfassten Protokolle behandelt und belastet werden.
properties.restoredLogs	RestoredLogs	Parameter des Wiederherstellungsvorgangs, der diese Tabelle initiiert hat.
properties.retentionInDays	integer	Die Tabellenaufbewahrung in Tagen zwischen 4 und 730. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig die Arbeitsbereichsaufbewahrung verwendet.
properties.schema	Schema	Tabellenschema
properties.searchResults	SearchResults	Parameter des Suchauftrags, der diese Tabelle initiiert hat.
properties.totalRetentionInDays	integer	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 (Zeitintensiver Vorgang).
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

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	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=2023-09-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=2023-09-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=2023-09-01

Definitionen

Name	Beschreibung
Column	Tabellenspalte.
ColumnDataTypeHintEnum	Logischer Hinweis des Spaltendatentyps.
ColumnTypeEnum	Spaltendatentyp.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
ProvisioningStateEnum	Der aktuelle Bereitstellungsstatus der Tabelle. Wenn diese Einstellung auf "aktualisieren" festgelegt ist, wird eine Ressourcensperre aufgrund des laufenden Betriebs angezeigt, soweit keine Aktualisierung der Tabelle möglich ist, bis der laufende Vorgang abgeschlossen ist.
RestoredLogs	Wiederherstellen von Parametern.
ResultStatistics	Statistiken zur Ausführung von Suchaufträgen.
Schema	Das Schema der Tabelle.
SearchResults	Parameter des Suchauftrags, der diese Tabelle initiiert hat.
SourceEnum	Ersteller der Tabelle.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Table	Definition der Arbeitsbereichsdatentabelle.
TablePlanEnum	Weisen Sie das System an, wie die in dieser Tabelle erfassten Protokolle behandelt und belastet werden.
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

Tabellenspalte.

Name	Typ	Beschreibung
dataTypeHint	ColumnDataTypeHintEnum	Logischer Hinweis des Spaltendatentyps.
description	string	Spaltenbeschreibung.
displayName	string	Spaltenanzeigename.
isDefaultDisplay	boolean	Wird standardmäßig angezeigt.
isHidden	boolean	Spalte ausgeblendet.
name	string	Spaltenname.
type	ColumnTypeEnum	Spaltendatentyp.

ColumnDataTypeHintEnum

Logischer Hinweis des Spaltendatentyps.

Name	Typ	Beschreibung
armPath	string	Ein ARM-Pfad (Azure Resource Model): /subscriptions/{...} /resourceGroups/{...} /providers/Microsoft. {...} /{...} /{...} /{...} ...
guid	string	Eine Standardmäßige 128-Bit-GUID nach der Standardform xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
ip	string	Eine Standard-V4/V6-IP-Adresse, die der Standardform folgt, x.x.x.x/y:y:y:y:y:y:y:y:y
uri	string	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

Spaltendatentyp.

Name	Typ	Beschreibung
boolean	string
dateTime	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

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

ErrorDetail

Die Fehlerdetails.

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

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ProvisioningStateEnum

Der aktuelle Bereitstellungsstatus der Tabelle. Wenn diese Einstellung auf "aktualisieren" festgelegt ist, wird eine Ressourcensperre aufgrund des laufenden Betriebs angezeigt, soweit keine Aktualisierung der Tabelle möglich ist, bis der laufende Vorgang abgeschlossen ist.

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

RestoredLogs

Wiederherstellen von Parametern.

Name	Typ	Beschreibung
azureAsyncOperationId	string	Id des asynchronen Vorgangs der Suchergebnistabelle.
endRestoreTime	string	Der Zeitstempel zum Beenden der Wiederherstellung durch (UTC).
sourceTable	string	Die Tabelle, aus der Daten wiederhergestellt werden sollen.
startRestoreTime	string	Der Zeitstempel, von dem aus die Wiederherstellung gestartet werden soll (UTC).

ResultStatistics

Statistiken zur Ausführung von Suchaufträgen.

Name	Typ	Beschreibung
ingestedRecords	integer	Die Anzahl der Zeilen, die vom Suchauftrag zurückgegeben wurden.
progress	number	Prozentsatz des Abschlusses von Suchaufträgen.
scannedGb	number	Suchauftrag: Die Menge der gescannten Daten.

Schema

Das Schema der Tabelle.

Name	Typ	Beschreibung
categories	string[]	Tabellenkategorie.
columns	Column[]	Eine Liste benutzerdefinierter Tabellenspalten.
description	string	Tabellenbeschreibung.
displayName	string	Tabellenanzeigename.
labels	string[]	Tabellenbeschriftungen.
name	string	Tabellenname.
solutions	string[]	Liste der Lösungen, denen die Tabelle zugeordnet ist
source	SourceEnum	Ersteller der Tabelle.
standardColumns	Column[]	Eine Liste der Standardspalten der Tabelle.
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

Parameter des Suchauftrags, der diese Tabelle initiiert hat.

Name	Typ	Beschreibung
azureAsyncOperationId	string	Id des asynchronen Vorgangs der Suchergebnistabelle.
description	string	Suchauftragsbeschreibung.
endSearchTime	string	Der Zeitstempel zum Beenden der Suche nach (UTC)
limit	integer	Beschränken Sie den Suchauftrag so, dass bis zu der angegebenen Anzahl von Zeilen zurückgegeben wird.
query	string	Suchauftragsabfrage.
sourceTable	string	Die im Suchauftrag verwendete Tabelle.
startSearchTime	string	Der Zeitstempel, von dem aus die Suche gestartet werden soll (UTC)

SourceEnum

Ersteller der Tabelle.

Name	Typ	Beschreibung
customer	string	Tabellen, die vom Besitzer des Arbeitsbereichs erstellt und nur in diesem Arbeitsbereich gefunden werden.
microsoft	string	Tabellen, die vom System bereitgestellt werden, wie sie über Diagnoseeinstellungen, die Agents oder andere Standarddatensammlungsmittel gesammelt werden.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	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	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

Definition der Arbeitsbereichsdatentabelle.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.archiveRetentionInDays	integer	Die Aufbewahrung der Tabellendatenarchive in Tagen. Berechnet als (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	Der Zeitstempel, der für den Tabellenplan zuletzt geändert wurde (UTC).
properties.plan	TablePlanEnum	Weisen Sie das System an, wie die in dieser Tabelle erfassten Protokolle behandelt und belastet werden.
properties.provisioningState	ProvisioningStateEnum	Der aktuelle Bereitstellungsstatus der Tabelle. Wenn diese Einstellung auf "aktualisieren" festgelegt ist, wird eine Ressourcensperre aufgrund des laufenden Betriebs angezeigt, soweit keine Aktualisierung der Tabelle möglich ist, bis der laufende Vorgang abgeschlossen ist.
properties.restoredLogs	RestoredLogs	Parameter des Wiederherstellungsvorgangs, der diese Tabelle initiiert hat.
properties.resultStatistics	ResultStatistics	Statistiken zur Ausführung von Suchaufträgen.
properties.retentionInDays	integer	Die Tabellenaufbewahrung in Tagen zwischen 4 und 730. Wenn Sie diese Eigenschaft auf -1 festlegen, wird standardmäßig die Arbeitsbereichsaufbewahrung verwendet.
properties.retentionInDaysAsDefault	boolean	True: Der 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	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 : Der Wert stammt aus der Aufbewahrung in Tagen, False – kundenspezifisch.
systemData	systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
type	string	Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

TablePlanEnum

Weisen Sie das System an, wie die in dieser Tabelle erfassten Protokolle behandelt und belastet werden.

Name	Typ	Beschreibung
Analytics	string	Protokolle, die Überwachung und Analyse ermöglichen.
Basic	string	Protokolle, die angepasst werden, um ausführliche Protokolle mit hohem Volumen mit geringem Wert zu unterstützen.

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.

Name	Typ	Beschreibung
Any	string	Der Standarduntertyp, mit dem integrierte Tabellen erstellt werden.
Classic	string	Gibt eine Tabelle an, die über die Datensammler-API oder mit dem Feature für benutzerdefinierte Protokolle des MMA-Agents erstellt wurde, oder eine beliebige Tabelle, für die benutzerdefinierte Felder erstellt wurden.
DataCollectionRuleBased	string	Eine Tabelle, die berechtigt ist, Daten über eine der von Datensammlungsregeln unterstützten Mittel in sie zu senden: die Datensammlungsendpunkt-API, Transformationen zur Erfassungszeit oder einen anderen Mechanismus, der von Datensammlungsregeln bereitgestellt wird.

TableTypeEnum