Tables - Create Or Update

Servizio:: Log Analytics

Versione API:: 2026-03-01

Aggiornare o creare una tabella dell'area di lavoro Log Analytics.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	Nome della tabella.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nome dell'area di lavoro.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.plan	TablePlanEnum	Indicare al sistema come gestire e caricare i log inseriti in questa tabella.
properties.protectionLevel	TableProtectionLevelEnum	Il livello di protezione del tavolo. Determina il comportamento predefinito di isolamento dell'accesso ai dati.
properties.restoredLogs	RestoredLogs	Parametri dell'operazione di ripristino che ha avviato questa tabella.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Nella tabella Analytics: la conservazione dell'analisi delle tabelle in giorni, tra 4 e 730. L'impostazione di questa proprietà su -1 verrà impostata per impostazione predefinita sulla conservazione dell'area di lavoro. Nella tabella Base e Ausiliaria: proprietà di sola lettura.
properties.schema	Schema	Schema tabella.
properties.searchResults	SearchResults	Parametri del processo di ricerca che ha avviato questa tabella.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Conservazione totale della tabella in giorni, compresa tra 4 e 4383. L'impostazione predefinita di questa proprietà su -1 sarà retentionInDays.

Risposte

Nome	Tipo	Descrizione
200 OK	Table	Operazione di aggiornamento della 'Tabella' della risorsa riuscita
202 Accepted		Operazione sulle risorse accettata. Intestazioni Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

Table

Operazione di aggiornamento della 'Tabella' della risorsa riuscita

202 Accepted

Operazione sulle risorse accettata.

Intestazioni

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

TablesUpsert

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 200

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

Codice di stato:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperaitonalInsights/workspaces/oiautorest6685/tables/table1_CL/operationresults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01
azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.OperaitonalInsights/locations/eastus/operationstatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01

Definizioni

Nome	Descrizione
Column	Colonna tabella.
ColumnDataTypeHintEnum	Hint logico per il tipo di dati della colonna.
ColumnTypeEnum	Tipo di dati della colonna.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
OperationalInsightsTableProvisioningState	Stato di provisioning corrente della tabella. Se impostato su "aggiornamento", indica un blocco della risorsa a causa di un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino alla conclusione dell'operazione in corso.
RestoredLogs	Ripristinare i parametri.
ResultStatistics	Statistiche di esecuzione del processo di ricerca.
Schema	Schema della tabella.
SearchResults	Parametri del processo di ricerca che ha avviato questa tabella.
SourceEnum	Creatore del tavolo.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
Table	Definizione della tabella dati dell'area di lavoro.
TablePlanEnum	Indicare al sistema come gestire e caricare i log inseriti in questa tabella.
TableProtectionLevelEnum	Il livello di protezione del tavolo. Determina il comportamento predefinito di isolamento dell'accesso ai dati.
TableSubTypeEnum	Il sottotipo descrive quali API possono essere usate per interagire con la tabella e quali funzionalità sono disponibili per essa.
TableTypeEnum	Creatore del tavolo.

Column

Oggetto

Colonna tabella.

Nome	Tipo	Descrizione
dataTypeHint	ColumnDataTypeHintEnum	Hint logico per il tipo di dati della colonna.
description	string	Descrizione colonna.
displayName	string	Nome visualizzato della colonna. Può essere impostato al momento della creazione; Dopo la creazione, gli aggiornamenti devono corrispondere al nome della colonna o impostare su null/vuoto. Se non è fornito, di default si applica al nome della colonna.
isDefaultDisplay	boolean	Viene visualizzato per impostazione predefinita.
isHidden	boolean	Colonna nascosta.
name	string	Nome colonna.
type	ColumnTypeEnum	Tipo di dati della colonna.

ColumnDataTypeHintEnum

Enumerazione

Hint logico per il tipo di dati della colonna.

Valore	Descrizione
uri	Stringa che corrisponde al modello di un URI, ad esempio scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment
guid	GUID a 128 bit standard che segue la forma standard xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
armPath	Percorso del modello di risorse di Azure: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
ip	Indirizzo IP V4/V6 standard che segue la forma standard, x.x.x.x/y:y:y:y:y:y:y:y:y:y
vector16	Un vettore di valori in virgola mobile a precisione singola utilizzato per la ricerca semantica / di similarità.

ColumnTypeEnum

Enumerazione

Tipo di dati della colonna.

Valore	Descrizione
string	corda
int	int
long	lungo
real	real
boolean	Boolean
dateTime	data e ora
guid	guid
dynamic	Dinamico

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	La destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

OperationalInsightsTableProvisioningState

Enumerazione

Stato di provisioning corrente della tabella. Se impostato su "aggiornamento", indica un blocco della risorsa a causa di un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino alla conclusione dell'operazione in corso.

Valore	Descrizione
Updating	Lo schema di tabella è ancora in fase di compilazione e aggiornamento, la tabella è attualmente bloccata per tutte le modifiche fino a quando non viene eseguita la procedura.
InProgress	Lo schema della tabella è stabile e senza modifiche, i dati della tabella vengono aggiornati.
Succeeded	Lo stato della tabella è stabile e senza modifiche, la tabella viene sbloccata e aperta per i nuovi aggiornamenti.
Deleting	Lo stato della tabella è in fase di eliminazione.

RestoredLogs

Oggetto

Ripristinare i parametri.

Nome	Tipo	Descrizione
azureAsyncOperationId	string	ID operazione asincrona della tabella dei risultati della ricerca.
endRestoreTime	string (date-time)	Timestamp per terminare il ripristino in base alle ore UTC.
sourceTable	string	Tabella da cui ripristinare i dati.
startRestoreTime	string (date-time)	Timestamp per avviare il ripristino da (UTC).

ResultStatistics

Oggetto

Statistiche di esecuzione del processo di ricerca.

Nome	Tipo	Descrizione
ingestedRecords	integer (int32)	Numero di righe restituite dal processo di ricerca.
progress	number (float)	Percentuale di completamento del processo di ricerca.
scannedGb	number (float)	Processo di ricerca: quantità di dati analizzati.

Schema

Oggetto

Schema della tabella.

Nome	Tipo	Descrizione
categories	string[]	Categoria tabella.
columns	Column[]	Elenco di colonne personalizzate della tabella.
description	string	Descrizione della tabella.
displayName	string	Nome visualizzato tabella.
labels	string[]	Etichette di tabella.
name	string	Nome della tabella.
solutions	string[]	Elenco delle soluzioni a cui la tabella è affiliata
source	SourceEnum	Creatore del tavolo.
standardColumns	Column[]	Elenco di colonne standard della tabella.
tableSubType	TableSubTypeEnum	Il sottotipo descrive quali API possono essere usate per interagire con la tabella e quali funzionalità sono disponibili per essa.
tableType	TableTypeEnum	Creatore del tavolo.

SearchResults

Oggetto

Parametri del processo di ricerca che ha avviato questa tabella.

Nome	Tipo	Descrizione
azureAsyncOperationId	string	ID operazione asincrona della tabella dei risultati della ricerca.
description	string	Descrizione del processo di ricerca.
endSearchTime	string (date-time)	Timestamp per terminare la ricerca in base alle ore UTC
limit	integer (int32)	Limitare il processo di ricerca per restituire fino al numero specificato di righe.
query	string	Query del processo di ricerca.
sourceTable	string	Tabella utilizzata nel processo di ricerca.
startSearchTime	string (date-time)	Timestamp per avviare la ricerca da (UTC)

SourceEnum

Enumerazione

Creatore del tavolo.

Valore	Descrizione
microsoft	Tabelle di cui è stato effettuato il provisioning dal sistema, come raccolto tramite impostazioni di diagnostica, agenti o qualsiasi altro mezzo di raccolta dati standard.
customer	Tabelle create dal proprietario dell'area di lavoro e disponibili solo in questa area di lavoro.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Table

Oggetto

Definizione della tabella dati dell'area di lavoro.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	nome della risorsa.
properties.archiveRetentionInDays	integer (int32)	Le tabelle conservazione a lungo termine in giorni. Calcolato come (totalRetentionInDays-retentionInDays).
properties.lastPlanModifiedDate	string	Timestamp dell'ultima modifica del piano di tabella (UTC).
properties.plan	TablePlanEnum	Indicare al sistema come gestire e caricare i log inseriti in questa tabella.
properties.protectionLevel	TableProtectionLevelEnum	Il livello di protezione del tavolo. Determina il comportamento predefinito di isolamento dell'accesso ai dati.
properties.provisioningState	OperationalInsightsTableProvisioningState	Stato di provisioning corrente della tabella. Se impostato su "aggiornamento", indica un blocco della risorsa a causa di un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino alla conclusione dell'operazione in corso.
properties.restoredLogs	RestoredLogs	Parametri dell'operazione di ripristino che ha avviato questa tabella.
properties.resultStatistics	ResultStatistics	Statistiche di esecuzione del processo di ricerca.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Nella tabella Analytics: la conservazione dell'analisi delle tabelle in giorni, tra 4 e 730. L'impostazione di questa proprietà su -1 verrà impostata per impostazione predefinita sulla conservazione dell'area di lavoro. Nella tabella Base e Ausiliaria: proprietà di sola lettura.
properties.retentionInDaysAsDefault	boolean	True: il valore ha origine dalla conservazione dell'area di lavoro in giorni, False - Specifica del cliente.
properties.schema	Schema	Schema tabella.
properties.searchResults	SearchResults	Parametri del processo di ricerca che ha avviato questa tabella.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Conservazione totale della tabella in giorni, compresa tra 4 e 4383. L'impostazione predefinita di questa proprietà su -1 sarà retentionInDays.
properties.totalRetentionInDaysAsDefault	boolean	True: il valore ha origine dalla conservazione in giorni, False - Specifica del cliente.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TablePlanEnum

Enumerazione

Indicare al sistema come gestire e caricare i log inseriti in questa tabella.

Valore	Descrizione
Basic	Log di medio tocco necessari per la risoluzione dei problemi e la risposta agli incidenti.
Analytics	Log di alto valore utilizzati per il monitoraggio continuo, il rilevamento in tempo reale e l'analisi delle prestazioni.
Auxiliary	Registri low-touch, ad esempio registri dettagliati, e dati necessari per il controllo e la conformità.

TableProtectionLevelEnum

Enumerazione

Il livello di protezione del tavolo. Determina il comportamento predefinito di isolamento dell'accesso ai dati.

Valore	Descrizione
General	Il livello di protezione predefinito. I dati delle tabelle sono accessibili tramite permessi standard.
Protected	I dati della tabella sono isolati di default. L'accesso o l'esportazione dei dati richiede un'autorizzazione esplicita e a scopo specifico.

TableSubTypeEnum

Enumerazione

Il sottotipo descrive quali API possono essere usate per interagire con la tabella e quali funzionalità sono disponibili per essa.

Valore	Descrizione
Any	Sottotipo predefinito con cui vengono create le tabelle predefinite.
Classic	Indica una tabella creata tramite l'API agente di raccolta dati o con la funzionalità log personalizzati dell'agente MMA o qualsiasi tabella in cui sono stati creati campi personalizzati.
DataCollectionRuleBased	Una tabella idonea per l'invio dei dati tramite uno qualsiasi dei mezzi supportati dalle regole di raccolta dati: l'API dell'endpoint di raccolta dati, le trasformazioni in fase di inserimento o qualsiasi altro meccanismo fornito dalle regole di raccolta dati

TableTypeEnum

Enumerazione

Creatore del tavolo.

Valore	Descrizione
Microsoft	Dati standard raccolti da Monitoraggio di Azure.
CustomLog	Tabella di log personalizzata.
RestoredLogs	Dati ripristinati.
SearchResults	Dati raccolti da un processo di ricerca.