Tables - Create Or Update

Referência

Serviço:: Log Analytics

Versão da API:: 2025-02-01

Atualizar ou criar uma tabela de workspace 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 de URI

Nome	Em	Obrigató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 workspace.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
properties.plan	TablePlanEnum	Instrua o sistema 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 retenção da tabela em dias, entre 4 e 730. Definir essa propriedade como -1 padrão para a retenção do workspace.
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 retenção total da tabela em dias, entre 4 e 4383. Definir essa propriedade como -1 padrão será a retenção de tabela.

Respostas

Nome	Tipo	Description
200 OK	Table	Definição de resposta OK.
202 Accepted		Definição de resposta aceita (operação de execução longa).
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

TablesUpsert

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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 status:: 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

Nome	Description
Column	Coluna da tabela.
ColumnDataTypeHintEnum	Dica lógica de tipo de dados de coluna.
ColumnTypeEnum	Tipo de dados de coluna.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ProvisioningStateEnum	O estado de provisionamento atual da tabela. Se definido como "atualização", indica um bloqueio de recurso devido à operação em andamento, proibindo qualquer atualização para a tabela até que a operação em andamento seja concluída.
RestoredLogs	Restaurar parâmetros.
ResultStatistics	Pesquisar estatísticas de execução do trabalho.
Schema	Esquema da tabela.
SearchResults	Parâmetros do trabalho de pesquisa que iniciou esta tabela.
SourceEnum	Criador da tabela.
systemData	Metadados relativos à criação e última modificação do recurso.
Table	Definição da tabela de dados do workspace.
TablePlanEnum	Instrua o sistema 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 nela.
TableTypeEnum	Criador da tabela.

Column

Objeto

Coluna da tabela.

Nome	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	A coluna está oculta.
name	string	Nome da coluna.
type	ColumnTypeEnum	Tipo de dados de coluna.

ColumnDataTypeHintEnum

Enumeração

Dica lógica de tipo de dados de coluna.

Valor	Description
armPath	Um caminho do ARM (Modelo de Recurso do Azure): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	Um GUID padrão de 128 bits seguindo a forma padrão, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx
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 de 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

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
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

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ProvisioningStateEnum

Enumeração

O estado de provisionamento atual da tabela. Se definido como "atualização", indica um bloqueio de recurso devido à operação em andamento, proibindo qualquer atualização para a tabela até que a operação em andamento seja concluída.

Valor	Description
Deleting	O estado da tabela está excluindo.
InProgress	O esquema de 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 de tabela ainda está sendo compilado e atualizado, a tabela está bloqueada no momento para quaisquer alterações até que o procedimento seja feito.

RestoredLogs

Objeto

Restaurar parâmetros.

Nome	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 da qual restaurar dados.
startRestoreTime	string (date-time)	O carimbo de data/hora para iniciar a restauração de (UTC).

ResultStatistics

Objeto

Pesquisar estatísticas de execução do trabalho.

Nome	Tipo	Description
ingestedRecords	integer (int32)	O número de linhas que foram retornadas pelo trabalho de pesquisa.
progress	number multipleOf: 0.01	Percentual de conclusão do trabalho de pesquisa.
scannedGb	number multipleOf: 0.01	Trabalho de pesquisa: quantidade de dados verificados.

Schema

Objeto

Esquema da tabela.

Nome	Tipo	Description
categories	string[]	Categoria de tabela.
columns	Column[]	Uma lista de colunas personalizadas de 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 à qual 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 nela.
tableType	TableTypeEnum	Criador da tabela.

SearchResults

Objeto

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

Nome	Tipo	Description
azureAsyncOperationId	string	ID da operação assíncrona da tabela de resultados da pesquisa.
description	string	Descrição do trabalho de pesquisa.
endSearchTime	string (date-time)	O carimbo de data/hora para encerrar a pesquisa por (UTC)
limit	integer (int32)	Limite o trabalho de pesquisa para retornar até o número especificado de linhas.
query	string	Consulta de trabalho de pesquisa.
sourceTable	string	A tabela usada no trabalho de pesquisa.
startSearchTime	string (date-time)	O carimbo de data/hora do qual iniciar a pesquisa (UTC)

SourceEnum

Enumeração

Criador da tabela.

Valor	Description
customer	Tabelas criadas pelo proprietário do Workspace e encontradas somente neste Workspace.
microsoft	Tabelas provisionadas pelo sistema, conforme coletado por meio de Configurações de Diagnóstico, agentes ou qualquer outro meio de coleta de dados padrão.

systemData

Objeto

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

Nome	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

Objeto

Definição da tabela de dados do workspace.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada 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 arquivos de dados da tabela em dias. Calculado como (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	O carimbo de data/hora em que o plano de tabela foi modificado pela última vez (UTC).
properties.plan	TablePlanEnum	Instrua o sistema como manipular e carregar os logs ingeridos nesta tabela.
properties.provisioningState	ProvisioningStateEnum	O estado de provisionamento atual da tabela. Se definido como "atualização", indica um bloqueio de recurso devido à operação em andamento, proibindo qualquer atualização para a tabela até que a operação em andamento seja concluída.
properties.restoredLogs	RestoredLogs	Parâmetros da operação de restauração que iniciou esta tabela.
properties.resultStatistics	ResultStatistics	Pesquisar estatísticas de execução do trabalho.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	A retenção da tabela em dias, entre 4 e 730. Definir essa propriedade como -1 padrão para a retenção do workspace.
properties.retentionInDaysAsDefault	boolean	True – O valor se origina da retenção do workspace em dias, False – 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 retenção total da tabela em dias, entre 4 e 4383. Definir essa propriedade como -1 padrão será a retenção de tabela.
properties.totalRetentionInDaysAsDefault	boolean	True – O valor se origina da retenção em dias, False – específico do cliente.
systemData	systemData	Metadados relativos à 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 como manipular e carregar os logs ingeridos nesta tabela.

Valor	Description
Analytics	Logs que permitem monitoramento e análise.
Basic	Logs ajustados para dar suporte a logs detalhados de baixo valor de alto volume.

TableSubTypeEnum

Enumeração

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

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 campos personalizados foram criados.
DataCollectionRuleBased	Uma tabela qualificada para ter dados enviados para ele por meio de qualquer um dos meios compatíveis com regras de coleta de dados: a API de ponto de extremidade de coleta de dados, transformações em 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 coletados por um trabalho de pesquisa.

Compartilhar via

Tables - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

TablesUpsert

Solicitação de exemplo

Resposta de exemplo

Definições

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum

Recursos adicionais