Tables - Create Or Update

Servizio:: Log Analytics

Versione API:: 2025-07-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=2025-07-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 minLength: 1	ID della sottoscrizione di destinazione.
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.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	Definizione della risposta OK.
202 Accepted		Definizione della risposta accettata (operazione a esecuzione prolungata).
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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	rappresentare l'account utente

Esempio

TablesUpsert

Esempio di richiesta

HTTP

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
  }
}

Risposta di esempio

Codice di stato:: 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"
}

Codice di stato:: 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=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

Definizioni

Nome	Descrizione
Column	Colonna della 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
ProvisioningStateEnum	Stato di provisioning corrente della tabella. Se impostato su 'aggiornamento', indica un blocco delle risorse dovuto a un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino al termine dell'operazione in corso.
RestoredLogs	Ripristina 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.
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

Object

Colonna della 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.
isDefaultDisplay	boolean	Viene visualizzato per impostazione predefinita.
isHidden	boolean	La 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	Una 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	Un GUID standard a 128 bit che segue la forma standard, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
armPath	Un percorso di Azure Resource Model (ARM): /subscriptions/{...}/resourceGroups/{...}/fornitori/Microsoft. {...}/{...}/{...}/{...}...
ip	Un indirizzo IP V4/V6 standard che segue la forma standard, x.x.x.x/y:y:y:y:y:y

ColumnTypeEnum

Enumerazione

Tipo di dati della colonna.

Valore	Descrizione
string
int
long
real
boolean
dateTime
guid
dynamic

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Object

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	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ProvisioningStateEnum

Enumerazione

Stato di provisioning corrente della tabella. Se impostato su 'aggiornamento', indica un blocco delle risorse dovuto a un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino al termine dell'operazione in corso.

Valore	Descrizione
Updating	Lo schema della tabella è ancora in fase di creazione e aggiornamento, la tabella è attualmente bloccata per eventuali modifiche fino al completamento della 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 è sbloccata e aperta per nuovi aggiornamenti.
Deleting	Lo stato della tabella è in fase di eliminazione.

RestoredLogs

Object

Ripristina 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

Object

Statistiche di esecuzione del processo di ricerca.

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

Schema

Object

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 delle tabelle.
name	string	Nome della tabella.
solutions	string[]	Elenco delle soluzioni a cui la tabella è affiliata
source	SourceEnum	Creatore del tavolo.
standardColumns	Column[]	Elenco delle 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

Object

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, raccolte tramite le Impostazioni di diagnostica, gli agenti o qualsiasi altro mezzo standard di raccolta dati.
customer	Tabelle create dal proprietario dell'area di lavoro e disponibili solo in questa area di lavoro.

systemData

Object

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

Object

Definizione della tabella dati dell'area di lavoro.

Nome	Tipo	Descrizione
id	string	ID risorsa completo 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	Il timestamp dell'ultima modifica del piano della tabella (UTC).
properties.plan	TablePlanEnum	Indicare al sistema come gestire e caricare i log inseriti in questa tabella.
properties.provisioningState	ProvisioningStateEnum	Stato di provisioning corrente della tabella. Se impostato su 'aggiornamento', indica un blocco delle risorse dovuto a un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino al termine 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 proviene dalla conservazione dell'area di lavoro in giorni, False - Specifico 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 proviene dalla conservazione in giorni, False - Specifico del cliente.
systemData	systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
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à.

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 dell'agente di raccolta dati o con la funzionalità dei log personalizzati dell'agente MMA o qualsiasi tabella in cui sono stati creati i campi personalizzati.
DataCollectionRuleBased	Una tabella idonea per l'invio di 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.

Condividi tramite

Tables - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

TablesUpsert

Esempio di richiesta

Risposta di esempio

Definizioni

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum