Tables - Create Or Update

Riferimento

Servizio:: Log Analytics

Versione API:: 2025-02-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-02-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra 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	Conservazione della tabella in giorni, compresa tra 4 e 730. L'impostazione di questa proprietà su -1 verrà impostata per impostazione predefinita sulla conservazione dell'area di lavoro.
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 di questa proprietà su -1 verrà impostata per impostazione predefinita sulla conservazione delle tabelle.

Risposte

Nome	Tipo	Descrizione
200 OK	Table	Definizione di risposta OK.
202 Accepted		Definizione di 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-02-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-02-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-02-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
ProvisioningStateEnum	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 della tabella.
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 le API che possono essere usate per interagire con la tabella e quali funzionalità sono disponibili.
TableTypeEnum	Creatore della tabella.

Column

Object

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.
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
armPath	Percorso del modello di risorse di Azure: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	GUID a 128 bit standard che segue la forma standard xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
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
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

ColumnTypeEnum

Enumerazione

Tipo di dati della colonna.

Valore	Descrizione
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

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 della risorsa a causa di un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino alla conclusione dell'operazione in corso.

Valore	Descrizione
Deleting	Lo stato della tabella viene eliminato.
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.
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.

RestoredLogs

Object

Ripristinare i parametri.

Nome	Tipo	Descrizione
azureAsyncOperationId	string	Tabella dei risultati della ricerca con ID operazione asincrona.
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 analizzati.

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 di tabella.
name	string	Nome tabella.
solutions	string[]	Elenco di soluzioni la tabella è affiliata con
source	SourceEnum	Creatore della tabella.
standardColumns	Column[]	Elenco di colonne standard della tabella.
tableSubType	TableSubTypeEnum	Il sottotipo descrive le API che possono essere usate per interagire con la tabella e quali funzionalità sono disponibili.
tableType	TableTypeEnum	Creatore della tabella.

SearchResults

Object

Parametri del processo di ricerca che ha avviato questa tabella.

Nome	Tipo	Descrizione
azureAsyncOperationId	string	Tabella dei risultati della ricerca con ID operazione asincrona.
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 della tabella.

Valore	Descrizione
customer	Tabelle create dal proprietario dell'area di lavoro e disponibili solo in questa area di lavoro.
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.

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)	Conservazione dell'archivio dati della tabella 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.provisioningState	ProvisioningStateEnum	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	Conservazione della tabella in giorni, compresa tra 4 e 730. L'impostazione di questa proprietà su -1 verrà impostata per impostazione predefinita sulla conservazione dell'area di lavoro.
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 di questa proprietà su -1 verrà impostata per impostazione predefinita sulla conservazione delle tabelle.
properties.totalRetentionInDaysAsDefault	boolean	True: il valore ha origine dalla conservazione in giorni, False - Specifica del cliente.
systemData	systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
type	string	Tipo della 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
Analytics	Log che consentono il monitoraggio e l'analisi.
Basic	Log modificati per supportare log dettagliati di volumi elevati con un volume basso.

TableSubTypeEnum

Enumerazione

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

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 della tabella.

Valore	Descrizione
CustomLog	Tabella di log personalizzata.
Microsoft	Dati standard raccolti da Monitoraggio di Azure.
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

Risorse aggiuntive