Condividi tramite

Tables - Create Or Update

  • Riferimento
Servizio:
Log Analytics
Versione API:
2023-09-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=2023-09-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
subscriptionId
 path True

string

ID della sottoscrizione di destinazione.
tableName
 path True

string

Nome della tabella.

Criterio di espressione regolare: ^[A-Za-z0-9-_]+$
workspaceName
 path True

string

Nome dell'area di lavoro.

Criterio di espressione regolare: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

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

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

SearchResults

Parametri del processo di ricerca che ha avviato questa tabella.
properties.totalRetentionInDays

integer

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

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow?api-version=2023-09-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=2023-09-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=2023-09-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 di risorse a causa di un'operazione in corso, vietando qualsiasi aggiornamento alla tabella fino alla conclusione dell'operazione in corso.
RestoredLogs

Ripristinare i parametri.
ResultStatistics

Cercare le statistiche di esecuzione del processo.
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 è possibile usare per interagire con la tabella e quali funzionalità sono disponibili.
TableTypeEnum

Creatore della tabella.

Column

Colonna tabella.

Nome Tipo Descrizione
dataTypeHint

ColumnDataTypeHintEnum

Hint logico per il tipo di dati della colonna.
description

string

Descrizione colonna.
displayName

string

Nome visualizzato colonna.
isDefaultDisplay

boolean

Viene visualizzato per impostazione predefinita.
isHidden

boolean

Colonna nascosta.
name

string

Nome colonna.
type

ColumnTypeEnum

Tipo di dati della colonna.

ColumnDataTypeHintEnum

Hint logico per il tipo di dati della colonna.

Nome Tipo Descrizione
armPath

string

Percorso del modello di risorse di Azure: /subscriptions/{...} /resourceGroups/{...} /providers/Microsoft. {...} /{...} /{...} /{...} ...
guid

string

GUID a 128 bit standard che segue la forma standard xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx
ip

string

Indirizzo IP V4/V6 standard che segue la forma standard x.x.x.x/y:y:y:y:y:y:y:y:y
uri

string

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

Tipo di dati della colonna.

Nome Tipo Descrizione
boolean

string

dateTime

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

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

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ProvisioningStateEnum

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

Nome Tipo Descrizione
Deleting

string

Lo stato della tabella viene eliminato.
InProgress

string

Lo schema della tabella è stabile e senza modifiche, i dati della tabella vengono aggiornati.
Succeeded

string

Lo stato della tabella è stabile e senza modifiche, la tabella viene sbloccata e aperta per i nuovi aggiornamenti.
Updating

string

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

Ripristinare i parametri.

Nome Tipo Descrizione
azureAsyncOperationId

string

Tabella dei risultati della ricerca con ID operazione asincrona.
endRestoreTime

string

Timestamp per terminare il ripristino entro (UTC).
sourceTable

string

Tabella da cui ripristinare i dati.
startRestoreTime

string

Timestamp per avviare il ripristino da (UTC).

ResultStatistics

Cercare le statistiche di esecuzione del processo.

Nome Tipo Descrizione
ingestedRecords

integer

Numero di righe restituite dal processo di ricerca.
progress

number

Percentuale di completamento del processo di ricerca.
scannedGb

number

Processo di ricerca: quantità di dati analizzati.

Schema

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 di soluzioni a cui la tabella è affiliata
source

SourceEnum

Creatore della tabella.
standardColumns

Column[]

Elenco di colonne standard della tabella.
tableSubType

TableSubTypeEnum

Il sottotipo descrive le API che è possibile usare per interagire con la tabella e quali funzionalità sono disponibili.
tableType

TableTypeEnum

Creatore della tabella.

SearchResults

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

Timestamp per terminare la ricerca in base alle ore (UTC)
limit

integer

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

Timestamp per avviare la ricerca da (UTC)

SourceEnum

Creatore della tabella.

Nome Tipo Descrizione
customer

string

Tabelle create dal proprietario dell'area di lavoro e disponibili solo in questa area di lavoro.
microsoft

string

Tabelle di cui è stato effettuato il provisioning dal sistema, raccolte tramite impostazioni di diagnostica, agenti o qualsiasi altro mezzo di raccolta dati standard.

systemData

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

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).
createdBy

string

Identità che ha creato la risorsa.
createdByType

createdByType

Tipo di identità che ha creato la risorsa.
lastModifiedAt

string

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

Definizione della tabella dati dell'area di lavoro.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

nome della risorsa.
properties.archiveRetentionInDays

integer

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 di risorse 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

Cercare le statistiche di esecuzione del processo.
properties.retentionInDays

integer

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

SearchResults

Parametri del processo di ricerca che ha avviato questa tabella.
properties.totalRetentionInDays

integer

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 di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TablePlanEnum

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

Nome Tipo Descrizione
Analytics

string

Log che consentono il monitoraggio e l'analisi.
Basic

string

Log modificati per supportare log dettagliati con volumi elevati con un valore basso.

TableSubTypeEnum

Il sottotipo descrive le API che è possibile usare per interagire con la tabella e quali funzionalità sono disponibili.

Nome Tipo Descrizione
Any

string

Sottotipo predefinito con cui vengono create le tabelle predefinite.
Classic

string

Indica una tabella creata tramite l'API dell'agente di raccolta dati o con la funzionalità log personalizzati dell'agente MMA o qualsiasi tabella in base alla quale sono stati creati campi personalizzati.
DataCollectionRuleBased

string

Una tabella idonea per l'invio dei dati tramite uno qualsiasi dei mezzi supportati dalle regole di raccolta dati: l'API endpoint di raccolta dati, le trasformazioni in fase di inserimento o qualsiasi altro meccanismo fornito dalle regole di raccolta dati

TableTypeEnum

Creatore della tabella.

Nome Tipo Descrizione
CustomLog

string

Tabella di log personalizzata.
Microsoft

string

Dati standard raccolti da Monitoraggio di Azure.
RestoredLogs

string

Dati ripristinati.
SearchResults

string

Dati raccolti da un processo di ricerca.