Partilhar via

Tables - Create Or Update

  • Referência
Serviço:
Log Analytics
Versão da API:
2025-02-01

Atualize ou crie uma tabela de espaço de trabalho do Log Analytics.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId
 path True

string

minLength: 1

A ID da assinatura de destino.
tableName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9-_]+$

O nome da tabela.
workspaceName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

O nome do espaço de trabalho.
api-version
 query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo do Pedido

Name Tipo Description
properties.plan

TablePlanEnum

Instrua o sistema sobre como manipular e carregar os logs ingeridos nesta tabela.
properties.restoredLogs

RestoredLogs

Parâmetros da operação de restauração que iniciou esta tabela.
properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

A tabela de retenção em dias, entre 4 e 730. Definir essa propriedade como -1 será padrão para a retenção do espaço de trabalho.
properties.schema

Schema

Esquema de tabela.
properties.searchResults

SearchResults

Parâmetros do trabalho de pesquisa que iniciou esta tabela.
properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 4383

A tabela retenção total em dias, entre 4 e 4383. Definir essa propriedade como -1 será padrão para retenção de tabela.

Respostas

Name Tipo Description
200 OK

Table

Definição de resposta OK.
202 Accepted

Definição de resposta aceite (operação de longa duração).
Other Status Codes

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

TablesUpsert

Pedido de amostra

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

Resposta da amostra

Código de estado:
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"
}
Código de estado:
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

Definições

Name Description
Column

Coluna da tabela.
ColumnDataTypeHintEnum

Dica lógica de tipo de dados de coluna.
ColumnTypeEnum

Tipo de dados da coluna.
createdByType

O tipo de identidade que criou o recurso.
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
ProvisioningStateEnum

Estado de provisionamento atual da tabela. Se definido como 'atualização', indica um bloqueio de recursos devido à operação em andamento, proibindo qualquer atualização da tabela até que a operação em curso seja concluída.
RestoredLogs

Restaurar parâmetros.
ResultStatistics

Pesquise estatísticas de execução de trabalho.
Schema

Esquema da tabela.
SearchResults

Parâmetros do trabalho de pesquisa que iniciou esta tabela.
SourceEnum

Criador da tabela.
systemData

Metadados referentes à criação e última modificação do recurso.
Table

Definição da tabela de dados do espaço de trabalho.
TablePlanEnum

Instrua o sistema sobre como manipular e carregar os logs ingeridos nesta tabela.
TableSubTypeEnum

O subtipo descreve quais APIs podem ser usadas para interagir com a tabela e quais recursos estão disponíveis em relação a ela.
TableTypeEnum

Criador da tabela.

Column

Object

Coluna da tabela.

Name Tipo Description
dataTypeHint

ColumnDataTypeHintEnum

Dica lógica de tipo de dados de coluna.
description

string

Descrição da coluna.
displayName

string

Nome de exibição da coluna.
isDefaultDisplay

boolean

É exibido por padrão.
isHidden

boolean

Está oculta a coluna.
name

string

Nome da coluna.
type

ColumnTypeEnum

Tipo de dados da coluna.

ColumnDataTypeHintEnum

Enumeração

Dica lógica de tipo de dados de coluna.

Valor Description
armPath

Um caminho ARM (Azure Resource Model): /subscriptions/{...}/resourceGroups/{...}/provedores/Microsoft. {...}/{...}/{...}/{...}...
guid

Um GUID padrão de 128 bits seguindo a forma padrão, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ip

Um endereço IP V4/V6 padrão seguindo a forma padrão, x.x.x.x/y:y:y:y:y:y:y:y:y
uri

Uma cadeia de caracteres que corresponde ao padrão de um URI, por exemplo, scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment

ColumnTypeEnum

Enumeração

Tipo de dados da coluna.

Valor Description
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Object

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ProvisioningStateEnum

Enumeração

Estado de provisionamento atual da tabela. Se definido como 'atualização', indica um bloqueio de recursos devido à operação em andamento, proibindo qualquer atualização da tabela até que a operação em curso seja concluída.

Valor Description
Deleting

O estado da tabela está sendo excluído.
InProgress

O esquema da tabela é estável e, sem alterações, os dados da tabela estão sendo atualizados.
Succeeded

O estado da tabela é estável e sem alterações, a tabela é desbloqueada e aberta para novas atualizações.
Updating

O esquema da tabela ainda está sendo construído e atualizado, a tabela está atualmente bloqueada para quaisquer alterações até que o procedimento seja concluído.

RestoredLogs

Object

Restaurar parâmetros.

Name Tipo Description
azureAsyncOperationId

string

Id da operação assíncrona da tabela de resultados da pesquisa.
endRestoreTime

string (date-time)

O carimbo de data/hora para encerrar a restauração por (UTC).
sourceTable

string

A tabela a partir da qual restaurar dados.
startRestoreTime

string (date-time)

O carimbo de data/hora para iniciar a restauração a partir de (UTC).

ResultStatistics

Object

Pesquise estatísticas de execução de trabalho.

Name Tipo Description
ingestedRecords

integer (int32)

O número de linhas que foram retornadas pelo trabalho de pesquisa.
progress

number

multipleOf: 0.01

Porcentagem de conclusão do trabalho de pesquisa.
scannedGb

number

multipleOf: 0.01

Procurar emprego: Quantidade de dados digitalizados.

Schema

Object

Esquema da tabela.

Name Tipo Description
categories

string[]

Categoria da tabela.
columns

Column[]

Uma lista de colunas personalizadas da tabela.
description

string

Descrição da tabela.
displayName

string

Nome de exibição da tabela.
labels

string[]

Rótulos de tabela.
name

string

Nome da tabela.
solutions

string[]

Lista de soluções com as quais a tabela está afiliada
source

SourceEnum

Criador da tabela.
standardColumns

Column[]

Uma lista de colunas padrão da tabela.
tableSubType

TableSubTypeEnum

O subtipo descreve quais APIs podem ser usadas para interagir com a tabela e quais recursos estão disponíveis em relação a ela.
tableType

TableTypeEnum

Criador da tabela.

SearchResults

Object

Parâmetros do trabalho de pesquisa que iniciou esta tabela.

Name Tipo Description
azureAsyncOperationId

string

Id da operação assíncrona da tabela de resultados da pesquisa.
description

string

Pesquisar Descrição da vaga.
endSearchTime

string (date-time)

O carimbo de data/hora para terminar a pesquisa por (UTC)
limit

integer (int32)

Limite o trabalho de pesquisa para retornar até o número especificado de linhas.
query

string

Procurar emprego.
sourceTable

string

A tabela usada no trabalho de pesquisa.
startSearchTime

string (date-time)

O carimbo de data/hora a partir de (UTC)

SourceEnum

Enumeração

Criador da tabela.

Valor Description
customer

Tabelas criadas pelo proprietário do Espaço de Trabalho e encontradas somente neste Espaço de Trabalho.
microsoft

Tabelas provisionadas pelo sistema, conforme coletadas por meio das Configurações de Diagnóstico, dos Agentes ou de qualquer outro meio padrão de coleta de dados.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

Table

Object

Definição da tabela de dados do espaço de trabalho.

Name Tipo Description
id

string

ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

O nome do recurso
properties.archiveRetentionInDays

integer (int32)

A retenção de arquivo de dados da tabela em dias. Calculado como (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate

string

O carimbo de data/hora que o plano de tabela foi modificado pela última vez (UTC).
properties.plan

TablePlanEnum

Instrua o sistema sobre como manipular e carregar os logs ingeridos nesta tabela.
properties.provisioningState

ProvisioningStateEnum

Estado de provisionamento atual da tabela. Se definido como 'atualização', indica um bloqueio de recursos devido à operação em andamento, proibindo qualquer atualização da tabela até que a operação em curso seja concluída.
properties.restoredLogs

RestoredLogs

Parâmetros da operação de restauração que iniciou esta tabela.
properties.resultStatistics

ResultStatistics

Pesquise estatísticas de execução de trabalho.
properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

A tabela de retenção em dias, entre 4 e 730. Definir essa propriedade como -1 será padrão para a retenção do espaço de trabalho.
properties.retentionInDaysAsDefault

boolean

True - O valor origina-se da retenção do espaço de trabalho em dias, Falso - específico do cliente.
properties.schema

Schema

Esquema de tabela.
properties.searchResults

SearchResults

Parâmetros do trabalho de pesquisa que iniciou esta tabela.
properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 4383

A tabela retenção total em dias, entre 4 e 4383. Definir essa propriedade como -1 será padrão para retenção de tabela.
properties.totalRetentionInDaysAsDefault

boolean

Verdadeiro - O valor origina-se da retenção em dias, Falso - específico do cliente.
systemData

systemData

Metadados referentes à criação e última modificação do recurso.
type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

TablePlanEnum

Enumeração

Instrua o sistema sobre como manipular e carregar os logs ingeridos nesta tabela.

Valor Description
Analytics

Logs que permitem monitoramento e análise.
Basic

Logs que são ajustados para suportar logs detalhados de alto volume e baixo valor.

TableSubTypeEnum

Enumeração

O subtipo descreve quais APIs podem ser usadas para interagir com a tabela e quais recursos estão disponíveis em relação a ela.

Valor Description
Any

O subtipo padrão com o qual as tabelas internas são criadas.
Classic

Indica uma tabela criada por meio da API do Coletor de Dados ou com o recurso de logs personalizados do agente MMA, ou qualquer tabela na qual os Campos Personalizados foram criados.
DataCollectionRuleBased

Uma tabela elegível para que os dados sejam enviados para ela por qualquer um dos meios suportados pelas Regras de Coleta de Dados: a API do Ponto Final de Coleta de Dados, transformações de tempo de ingestão ou qualquer outro mecanismo fornecido pelas Regras de Coleta de Dados

TableTypeEnum

Enumeração

Criador da tabela.

Valor Description
CustomLog

Tabela de log personalizada.
Microsoft

Dados padrão coletados pelo Azure Monitor.
RestoredLogs

Dados restaurados.
SearchResults

Dados recolhidos por um trabalho de pesquisa.