Tables - Create Or Update

Referência

Serviço:: Log Analytics

Versão da API:: 2023-09-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=2023-09-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string	A ID da assinatura de destino.
tableName	path	True	string	O nome da tabela. Padrão Regex: `^[A-Za-z0-9-_]+$`
workspaceName	path	True	string	O nome do workspace. Padrão Regex: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
api-version	query	True	string	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	A retenção da tabela em dias, entre 4 e 730. Definir essa propriedade como -1 usará como padrão a retenção do workspace.
properties.schema	Schema	Esquema da tabela.
properties.searchResults	SearchResults	Parâmetros do trabalho de pesquisa que iniciou esta tabela.
properties.totalRetentionInDays	integer	A retenção total da tabela em dias, entre 4 e 4383. Definir essa propriedade como -1 usará como padrão 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 do 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=2023-09-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=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

Definições

Nome	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	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	Os detalhes do erro.
ErrorResponse	Resposta de erro
ProvisioningStateEnum	Estado de provisionamento atual da tabela. Se definido como "atualizando", indica um bloqueio de recurso devido à operação em andamento, proibindo qualquer atualização na tabela até que a operação em andamento seja concluída.
RestoredLogs	Restaurar parâmetros.
ResultStatistics	Estatísticas de execução do trabalho de pesquisa.
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 cobrar 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

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 da coluna.

ColumnDataTypeHintEnum

Dica lógica de tipo de dados de coluna.

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

Tipo de dados da coluna.

Nome	Tipo	Description
boolean	string
dateTime	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

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

Os detalhes 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

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ProvisioningStateEnum

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

Nome	Tipo	Description
Deleting	string	O estado da tabela está sendo excluído.
InProgress	string	O esquema de tabela é estável e, sem alterações, os dados da tabela estão sendo atualizados.
Succeeded	string	O estado da tabela é estável e, sem alterações, a tabela é desbloqueada e aberta para novas atualizações.
Updating	string	O esquema de tabela ainda está sendo criado e atualizado. No momento, a tabela está bloqueada para quaisquer alterações até que o procedimento seja feito.

RestoredLogs

Restaurar parâmetros.

Nome	Tipo	Description
azureAsyncOperationId	string	ID da operação assíncrona da tabela de resultados da pesquisa.
endRestoreTime	string	O carimbo de data/hora para encerrar a restauração por (UTC).
sourceTable	string	A tabela da qual restaurar dados.
startRestoreTime	string	O carimbo de data/hora do qual iniciar a restauração (UTC).

ResultStatistics

Estatísticas de execução do trabalho de pesquisa.

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

Schema

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 às qual a tabela é 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

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	O carimbo de data/hora para encerrar a pesquisa por (UTC)
limit	integer	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	O carimbo de data/hora do qual iniciar a pesquisa (UTC)

SourceEnum

Criador da tabela.

Nome	Tipo	Description
customer	string	Tabelas criadas pelo proprietário do Workspace e encontradas somente neste Workspace.
microsoft	string	Tabelas provisionadas pelo sistema, conforme coletado por meio das Configurações de Diagnóstico, dos Agentes ou de qualquer outra coleta de dados padrão.

systemData

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

Nome	Tipo	Description
createdAt	string	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	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

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	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 cobrar os logs ingeridos nesta tabela.
properties.provisioningState	ProvisioningStateEnum	Estado de provisionamento atual da tabela. Se definido como "atualizando", indica um bloqueio de recurso devido à operação em andamento, proibindo qualquer atualização na 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	Estatísticas de execução do trabalho de pesquisa.
properties.retentionInDays	integer	A retenção da tabela em dias, entre 4 e 730. Definir essa propriedade como -1 usará como padrão 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 da tabela.
properties.searchResults	SearchResults	Parâmetros do trabalho de pesquisa que iniciou esta tabela.
properties.totalRetentionInDays	integer	A retenção total da tabela em dias, entre 4 e 4383. Definir essa propriedade como -1 usará como padrão 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	Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

TablePlanEnum

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

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

TableSubTypeEnum

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

Nome	Tipo	Description
Any	string	O subtipo padrão com o qual as tabelas internas são criadas.
Classic	string	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	string	Uma tabela qualificada para ter dados enviados a ela 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 de tempo de ingestão ou qualquer outro mecanismo fornecido pelas Regras de Coleta de Dados

TableTypeEnum