Delen via


Tables - Create Or Update

Werk een Log Analytics-werkruimtetabel bij of maak deze.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string

minLength: 1

De id van het doelabonnement.

tableName
path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9-_]+$

De naam van de tabel.

workspaceName
path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

De naam van de werkruimte.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
properties.plan

TablePlanEnum

Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht.

properties.restoredLogs

RestoredLogs

Parameters van de herstelbewerking die deze tabel heeft gestart.

properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

In de tabel Analytics: de tabellen Analytics-retentie in dagen, tussen 4 en 730. Als u deze eigenschap instelt op -1 wordt de werkruimteretentie standaard ingesteld. In de tabel Basis en Hulp: alleen-lezen eigenschap.

properties.schema

Schema

Tabelschema.

properties.searchResults

SearchResults

Parameters van de zoektaak die deze tabel heeft gestart.

properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 4383

De totale retentie van de tabel in dagen, tussen 4 en 4383. Als u deze eigenschap instelt op -1, wordt standaard de status retentieInDays ingesteld.

Antwoorden

Name Type Description
200 OK

Table

OK antwoord definitie.

202 Accepted

Definitie van geaccepteerd antwoord (langlopende werking).

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

TablesUpsert

Voorbeeldaanvraag

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

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

Voorbeeldrespons

{
  "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=2025-07-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-07-01

Definities

Name Description
Column

Tabel kolom.

ColumnDataTypeHintEnum

Logische hint voor kolomgegevenstype.

ColumnTypeEnum

Kolomgegevenstype.

createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

ProvisioningStateEnum

De huidige inrichtingsstatus van de tabel. Als deze optie is ingesteld op 'bijwerken', wordt een resourcevergrendeling aangegeven vanwege een lopende bewerking, waardoor elke update van de tabel wordt verboden totdat de lopende bewerking is voltooid.

RestoredLogs

Parameters herstellen.

ResultStatistics

Statistieken voor het uitvoeren van een zoektaak.

Schema

Schema van de tabel.

SearchResults

Parameters van de zoektaak die deze tabel heeft gestart.

SourceEnum

Maker van de tabel.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Table

Definitie van de gegevenstabel van de werkruimte.

TablePlanEnum

Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht.

TableSubTypeEnum

Het subtype beschrijft welke API's kunnen worden gebruikt om met de tabel te communiceren en welke functies ervoor beschikbaar zijn.

TableTypeEnum

Maker van de tabel.

Column

Tabel kolom.

Name Type Description
dataTypeHint

ColumnDataTypeHintEnum

Logische hint voor kolomgegevenstype.

description

string

Kolombeschrijving.

displayName

string

Weergavenaam van kolom.

isDefaultDisplay

boolean

Wordt standaard weergegeven.

isHidden

boolean

Is kolom verborgen.

name

string

Kolomnaam.

type

ColumnTypeEnum

Kolomgegevenstype.

ColumnDataTypeHintEnum

Logische hint voor kolomgegevenstype.

Waarde Description
uri

Een tekenreeks die overeenkomt met het patroon van een URI, bijvoorbeeld scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment

guid

Een standaard 128-bits GUID volgens de standaardvorm, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

armPath

Een Azure Resource Model (ARM)-pad: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...

ip

Een standaard V4/V6 ip-adres volgens de standaardvorm, x.x.x.x/y:y:y:y:y:y:y

ColumnTypeEnum

Kolomgegevenstype.

Waarde Description
string
int
long
real
boolean
dateTime
guid
dynamic

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ProvisioningStateEnum

De huidige inrichtingsstatus van de tabel. Als deze optie is ingesteld op 'bijwerken', wordt een resourcevergrendeling aangegeven vanwege een lopende bewerking, waardoor elke update van de tabel wordt verboden totdat de lopende bewerking is voltooid.

Waarde Description
Updating

Het tabelschema wordt nog steeds gebouwd en bijgewerkt, de tabel is momenteel vergrendeld voor eventuele wijzigingen totdat de procedure is voltooid.

InProgress

Het tabelschema is stabiel en zonder wijzigingen worden tabelgegevens bijgewerkt.

Succeeded

De tabelstatus is stabiel en zonder wijzigingen, de tabel is ontgrendeld en open voor nieuwe updates.

Deleting

Tabelstatus wordt verwijderd.

RestoredLogs

Parameters herstellen.

Name Type Description
azureAsyncOperationId

string

Tabel met zoekresultaten asynchrone bedienings-id.

endRestoreTime

string (date-time)

De tijdstempel voor het beƫindigen van de herstelbewerking door (UTC).

sourceTable

string

De tabel waaruit gegevens moeten worden hersteld.

startRestoreTime

string (date-time)

De tijdstempel voor het starten van de herstelbewerking vanaf (UTC).

ResultStatistics

Statistieken voor het uitvoeren van een zoektaak.

Name Type Description
ingestedRecords

integer (int32)

Het aantal rijen dat door de zoektaak is geretourneerd.

progress

number

multipleOf: 0.01

Voltooiingspercentage van zoekopdrachten.

scannedGb

number

multipleOf: 0.01

Zoektaak: Hoeveelheid gescande gegevens.

Schema

Schema van de tabel.

Name Type Description
categories

string[]

Tabel categorie.

columns

Column[]

Een lijst met aangepaste tabelkolommen.

description

string

Tabelbeschrijving.

displayName

string

Weergavenaam van tabel.

labels

string[]

Tabel labels.

name

string

Tabelnaam.

solutions

string[]

Lijst met oplossingen waarbij de tafel is aangesloten

source

SourceEnum

Maker van de tabel.

standardColumns

Column[]

Een lijst met standaardkolommen in de tabel.

tableSubType

TableSubTypeEnum

Het subtype beschrijft welke API's kunnen worden gebruikt om met de tabel te communiceren en welke functies ervoor beschikbaar zijn.

tableType

TableTypeEnum

Maker van de tabel.

SearchResults

Parameters van de zoektaak die deze tabel heeft gestart.

Name Type Description
azureAsyncOperationId

string

Tabel met zoekresultaten asynchrone bedienings-id.

description

string

Zoektaakbeschrijving.

endSearchTime

string (date-time)

De tijdstempel voor het beƫindigen van de zoekopdracht op (UTC)

limit

integer (int32)

Beperk de zoektaak om maximaal het opgegeven aantal rijen te retourneren.

query

string

Zoektaakquery.

sourceTable

string

De tabel die wordt gebruikt in de zoektaak.

startSearchTime

string (date-time)

Het tijdstempel voor het starten van de zoekopdracht vanaf (UTC)

SourceEnum

Maker van de tabel.

Waarde Description
microsoft

Tabellen die door het systeem worden geleverd, zoals verzameld via diagnostische instellingen, de agenten of andere standaard gegevensverzamelingsmiddelen.

customer

Tabellen die zijn gemaakt door de eigenaar van de werkruimte en die alleen in deze werkruimte te vinden zijn.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Table

Definitie van de gegevenstabel van de werkruimte.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.archiveRetentionInDays

integer (int32)

De tabellen lange termijn retentie in dagen. Berekend als (totalRetentionInDays-retentionInDays).

properties.lastPlanModifiedDate

string

De tijdstempel van dat tabelplan is voor het laatst gewijzigd (UTC).

properties.plan

TablePlanEnum

Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht.

properties.provisioningState

ProvisioningStateEnum

De huidige inrichtingsstatus van de tabel. Als deze optie is ingesteld op 'bijwerken', wordt een resourcevergrendeling aangegeven vanwege een lopende bewerking, waardoor elke update van de tabel wordt verboden totdat de lopende bewerking is voltooid.

properties.restoredLogs

RestoredLogs

Parameters van de herstelbewerking die deze tabel heeft gestart.

properties.resultStatistics

ResultStatistics

Statistieken voor het uitvoeren van een zoektaak.

properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

In de tabel Analytics: de tabellen Analytics-retentie in dagen, tussen 4 en 730. Als u deze eigenschap instelt op -1 wordt de werkruimteretentie standaard ingesteld. In de tabel Basis en Hulp: alleen-lezen eigenschap.

properties.retentionInDaysAsDefault

boolean

Waar - Waarde komt voort uit het behoud van werkruimte in dagen, Onwaar - Klantspecifiek.

properties.schema

Schema

Tabelschema.

properties.searchResults

SearchResults

Parameters van de zoektaak die deze tabel heeft gestart.

properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 4383

De totale retentie van de tabel in dagen, tussen 4 en 4383. Als u deze eigenschap instelt op -1, wordt standaard de status retentieInDays ingesteld.

properties.totalRetentionInDaysAsDefault

boolean

Waar - Waarde komt voort uit retentie in dagen, Onwaar - Klantspecifiek.

systemData

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

TablePlanEnum

Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht.

Waarde Description
Basic

Medium-touch logs die nodig zijn voor het oplossen van problemen en het reageren op incidenten.

Analytics

Hoogwaardige logboeken die worden gebruikt voor continue bewaking, realtime detectie en prestatieanalyses.

Auxiliary

Logboeken met weinig contactgegevens, zoals uitgebreide logboeken, en gegevens die nodig zijn voor controle en naleving.

TableSubTypeEnum

Het subtype beschrijft welke API's kunnen worden gebruikt om met de tabel te communiceren en welke functies ervoor beschikbaar zijn.

Waarde Description
Any

Het standaard subtype waarmee ingebouwde tabellen worden gemaakt.

Classic

Geeft een tabel aan die is gemaakt via de Data Collector-API of met de functie voor aangepaste logboeken van de MMA-agent, of een tabel op basis waarvan aangepaste velden zijn gemaakt.

DataCollectionRuleBased

Een tabel die in aanmerking komt voor het verzenden van gegevens via een van de middelen die worden ondersteund door de regels voor gegevensverzameling: de API voor het eindpunt voor gegevensverzameling, opnametijdtransformaties of een ander mechanisme dat wordt geboden door regels voor gegevensverzameling

TableTypeEnum

Maker van de tabel.

Waarde Description
Microsoft

Standaardgegevens die worden verzameld door Azure Monitor.

CustomLog

Aangepaste logtabel.

RestoredLogs

Herstelde gegevens.

SearchResults

Gegevens verzameld door een zoekopdracht.