Tables - Create Or Update

Referencia

Servicio:: Log Analytics

Versión de la API:: 2025-02-01

Actualice o cree una tabla de área de trabajo de 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 identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	Nombre de la tabla.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nombre del área de trabajo.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties.plan	TablePlanEnum	Indique al sistema cómo controlar y cargar los registros ingeridos en esta tabla.
properties.restoredLogs	RestoredLogs	Parámetros de la operación de restauración que inició esta tabla.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Retención de tablas en días, entre 4 y 730. Si establece esta propiedad en -1 se establecerá de forma predeterminada en la retención del área de trabajo.
properties.schema	Schema	Esquema de tabla.
properties.searchResults	SearchResults	Parámetros del trabajo de búsqueda que inició esta tabla.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	La retención total de la tabla en días, entre 4 y 4383. Al establecer esta propiedad en -1 se establecerá de forma predeterminada en la retención de tablas.

Respuestas

Nombre	Tipo	Description
200 OK	Table	Definición de respuesta correcta.
202 Accepted		Definición de respuesta aceptada (operación de ejecución prolongada).
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

TablesUpsert

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
}

status code:: 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

Definiciones

Nombre	Description
Column	Columna de tabla.
ColumnDataTypeHintEnum	Sugerencia lógica de tipo de datos de columna.
ColumnTypeEnum	Tipo de datos de columna.
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ProvisioningStateEnum	Estado de aprovisionamiento actual de la tabla. Si se establece en "actualización", indica un bloqueo de recursos debido a una operación en curso, prohibiendo cualquier actualización a la tabla hasta que finalice la operación en curso.
RestoredLogs	Restaurar parámetros.
ResultStatistics	Estadísticas de ejecución del trabajo de búsqueda.
Schema	Esquema de la tabla.
SearchResults	Parámetros del trabajo de búsqueda que inició esta tabla.
SourceEnum	Creador de la mesa.
systemData	Metadatos relativos a la creación y última modificación del recurso.
Table	Definición de la tabla de datos del área de trabajo.
TablePlanEnum	Indique al sistema cómo controlar y cargar los registros ingeridos en esta tabla.
TableSubTypeEnum	El subtipo describe qué API se pueden usar para interactuar con la tabla y qué características están disponibles en ella.
TableTypeEnum	Creador de la mesa.

Column

Object

Columna de tabla.

Nombre	Tipo	Description
dataTypeHint	ColumnDataTypeHintEnum	Sugerencia lógica de tipo de datos de columna.
description	string	Descripción de columna.
displayName	string	Nombre para mostrar de columna.
isDefaultDisplay	boolean	Se muestra de forma predeterminada.
isHidden	boolean	Es la columna oculta.
name	string	Nombre de columna.
type	ColumnTypeEnum	Tipo de datos de columna.

ColumnDataTypeHintEnum

Enumeración

Sugerencia lógica de tipo de datos de columna.

Valor	Description
armPath	Ruta de acceso del modelo de recursos de Azure (ARM): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	UN GUID estándar de 128 bits después de la forma estándar, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ip	Una dirección IP V4/V6 estándar que sigue a la forma estándar, x.x.x.x/y:y:y:y:y:y:y:y
uri	Cadena que coincide con el patrón de un URI, por ejemplo, scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment

ColumnTypeEnum

Enumeración

Tipo de datos de columna.

Valor	Description
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ProvisioningStateEnum

Enumeración

Estado de aprovisionamiento actual de la tabla. Si se establece en "actualización", indica un bloqueo de recursos debido a una operación en curso, prohibiendo cualquier actualización a la tabla hasta que finalice la operación en curso.

Valor	Description
Deleting	El estado de la tabla se está eliminando.
InProgress	El esquema de tabla es estable y sin cambios, se actualizan los datos de la tabla.
Succeeded	El estado de la tabla es estable y sin cambios, la tabla se desbloquea y se abre para las nuevas actualizaciones.
Updating	El esquema de tabla todavía se está compilando y actualizando, la tabla está bloqueada actualmente para los cambios hasta que se realice el procedimiento.

RestoredLogs

Object

Restaurar parámetros.

Nombre	Tipo	Description
azureAsyncOperationId	string	Id. de operación asincrónica de la tabla de resultados de búsqueda.
endRestoreTime	string (date-time)	Marca de tiempo para finalizar la restauración por (UTC).
sourceTable	string	Tabla desde la que se van a restaurar los datos.
startRestoreTime	string (date-time)	Marca de tiempo para iniciar la restauración desde (UTC).

ResultStatistics

Object

Estadísticas de ejecución del trabajo de búsqueda.

Nombre	Tipo	Description
ingestedRecords	integer (int32)	Número de filas devueltas por el trabajo de búsqueda.
progress	number multipleOf: 0.01	Porcentaje de finalización del trabajo de búsqueda.
scannedGb	number multipleOf: 0.01	Trabajo de búsqueda: cantidad de datos escaneados.

Schema

Object

Esquema de la tabla.

Nombre	Tipo	Description
categories	string[]	Categoría de tabla.
columns	Column[]	Lista de columnas personalizadas de tabla.
description	string	Descripción de la tabla.
displayName	string	Nombre para mostrar de la tabla.
labels	string[]	Etiquetas de tabla.
name	string	Nombre de la tabla.
solutions	string[]	Lista de soluciones con las que está afiliada la tabla
source	SourceEnum	Creador de la mesa.
standardColumns	Column[]	Lista de columnas estándar de tabla.
tableSubType	TableSubTypeEnum	El subtipo describe qué API se pueden usar para interactuar con la tabla y qué características están disponibles en ella.
tableType	TableTypeEnum	Creador de la mesa.

SearchResults

Object

Parámetros del trabajo de búsqueda que inició esta tabla.

Nombre	Tipo	Description
azureAsyncOperationId	string	Id. de operación asincrónica de la tabla de resultados de búsqueda.
description	string	Descripción del trabajo de búsqueda.
endSearchTime	string (date-time)	Marca de tiempo para finalizar la búsqueda por (UTC)
limit	integer (int32)	Limite el trabajo de búsqueda para devolver hasta el número especificado de filas.
query	string	Consulta de trabajo de búsqueda.
sourceTable	string	Tabla usada en el trabajo de búsqueda.
startSearchTime	string (date-time)	Marca de tiempo para iniciar la búsqueda desde (UTC)

SourceEnum

Enumeración

Creador de la mesa.

Valor	Description
customer	Tablas creadas por el propietario del área de trabajo y que solo se encuentran en esta área de trabajo.
microsoft	Tablas aprovisionadas por el sistema, como se recopilan a través de la configuración de diagnóstico, los agentes o cualquier otro medio de recopilación de datos estándar.

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Table

Object

Definición de la tabla de datos del área de trabajo.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso
properties.archiveRetentionInDays	integer (int32)	Retención del archivo de datos de tabla en días. Calculado como (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	Marca de tiempo que el plan de tabla se modificó por última vez (UTC).
properties.plan	TablePlanEnum	Indique al sistema cómo controlar y cargar los registros ingeridos en esta tabla.
properties.provisioningState	ProvisioningStateEnum	Estado de aprovisionamiento actual de la tabla. Si se establece en "actualización", indica un bloqueo de recursos debido a una operación en curso, prohibiendo cualquier actualización a la tabla hasta que finalice la operación en curso.
properties.restoredLogs	RestoredLogs	Parámetros de la operación de restauración que inició esta tabla.
properties.resultStatistics	ResultStatistics	Estadísticas de ejecución del trabajo de búsqueda.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Retención de tablas en días, entre 4 y 730. Si establece esta propiedad en -1 se establecerá de forma predeterminada en la retención del área de trabajo.
properties.retentionInDaysAsDefault	boolean	True: el valor se origina en la retención del área de trabajo en días, False: específico del cliente.
properties.schema	Schema	Esquema de tabla.
properties.searchResults	SearchResults	Parámetros del trabajo de búsqueda que inició esta tabla.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	La retención total de la tabla en días, entre 4 y 4383. Al establecer esta propiedad en -1 se establecerá de forma predeterminada en la retención de tablas.
properties.totalRetentionInDaysAsDefault	boolean	True: el valor se origina a partir de la retención en días, False: específico del cliente.
systemData	systemData	Metadatos relativos a la creación y última modificación del recurso.
type	string	Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TablePlanEnum

Enumeración

Indique al sistema cómo controlar y cargar los registros ingeridos en esta tabla.

Valor	Description
Analytics	Registros que permiten la supervisión y el análisis.
Basic	Registros que se ajustan para admitir registros detallados de bajo valor de gran volumen.

TableSubTypeEnum

Enumeración

El subtipo describe qué API se pueden usar para interactuar con la tabla y qué características están disponibles en ella.

Valor	Description
Any	Subtipo predeterminado con el que se crean tablas integradas.
Classic	Indica una tabla creada a través de Data Collector API o con la característica de registros personalizados del agente de MMA, o cualquier tabla con la que se crearon campos personalizados.
DataCollectionRuleBased	Una tabla apta para que los datos se envíen a él a través de cualquiera de los medios admitidos por las reglas de recopilación de datos: la API de punto de conexión de recopilación de datos, las transformaciones en tiempo de ingesta o cualquier otro mecanismo proporcionado por las reglas de recopilación de datos

TableTypeEnum

Enumeración

Creador de la mesa.

Valor	Description
CustomLog	Tabla de registro personalizada.
Microsoft	Datos estándar recopilados por Azure Monitor.
RestoredLogs	Datos restaurados.
SearchResults	Datos recopilados por un trabajo de búsqueda.

Compartir a través de

Tables - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

TablesUpsert

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum

Recursos adicionales