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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is hoofdletterongevoelig. |
|
subscription
|
path | True |
string minLength: 1 |
De id van het doelabonnement. |
|
table
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9-_]+$ |
De naam van de tabel. |
|
workspace
|
path | True |
string minLength: 4maxLength: 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 |
Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht. |
|
| properties.restoredLogs |
Parameters van de herstelbewerking die deze tabel heeft gestart. |
|
| properties.retentionInDays |
integer (int32) minimum: 4maximum: 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 |
Tabelschema. |
|
| properties.searchResults |
Parameters van de zoektaak die deze tabel heeft gestart. |
|
| properties.totalRetentionInDays |
integer (int32) minimum: 4maximum: 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 |
OK antwoord definitie. |
|
| 202 Accepted |
Definitie van geaccepteerd antwoord (langlopende werking). |
|
| Other Status Codes |
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. |
|
Column |
Logische hint voor kolomgegevenstype. |
|
Column |
Kolomgegevenstype. |
|
created |
Het type identiteit waarmee de resource is gemaakt. |
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
De foutdetails. |
|
Error |
Foutreactie |
|
Provisioning |
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. |
|
Restored |
Parameters herstellen. |
|
Result |
Statistieken voor het uitvoeren van een zoektaak. |
| Schema |
Schema van de tabel. |
|
Search |
Parameters van de zoektaak die deze tabel heeft gestart. |
|
Source |
Maker van de tabel. |
|
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
| Table |
Definitie van de gegevenstabel van de werkruimte. |
|
Table |
Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht. |
|
Table |
Het subtype beschrijft welke API's kunnen worden gebruikt om met de tabel te communiceren en welke functies ervoor beschikbaar zijn. |
|
Table |
Maker van de tabel. |
Column
Tabel kolom.
| Name | Type | Description |
|---|---|---|
| dataTypeHint |
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 |
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 |
De fout bevat aanvullende informatie. |
|
| code |
string |
De foutcode. |
| details |
De foutdetails. |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
| Name | Type | Description |
|---|---|---|
| error |
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 |
Maker van de tabel. |
|
| standardColumns |
Column[] |
Een lijst met standaardkolommen in de tabel. |
| tableSubType |
Het subtype beschrijft welke API's kunnen worden gebruikt om met de tabel te communiceren en welke functies ervoor beschikbaar zijn. |
|
| tableType |
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 |
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 |
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 |
Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht. |
|
| properties.provisioningState |
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 |
Parameters van de herstelbewerking die deze tabel heeft gestart. |
|
| properties.resultStatistics |
Statistieken voor het uitvoeren van een zoektaak. |
|
| properties.retentionInDays |
integer (int32) minimum: 4maximum: 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 |
Tabelschema. |
|
| properties.searchResults |
Parameters van de zoektaak die deze tabel heeft gestart. |
|
| properties.totalRetentionInDays |
integer (int32) minimum: 4maximum: 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 |
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. |