Freigeben über


Tables - Create Or Update

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=2022-10-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.

workspaceName
path True

string

Den Namen des Arbeitsbereichs

Regex pattern: ^[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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

TablesUpsert

Sample Request

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

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

Sample Response

{
  "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"
}
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=2022-10-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

Ersteller der Tabelle.

Name Typ Beschreibung
CustomLog

string

Benutzerdefinierte Protokolltabelle.

Microsoft

string

Von Azure Monitor gesammelte Standarddaten.

RestoredLogs

string

Wiederhergestellte Daten.

SearchResults

string

Von einem Suchauftrag gesammelte Daten.