Tables - Create Or Update

Servicio:

Log Analytics

Versión de la API:

2023-09-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=2023-09-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
tableName	path	True	string	Nombre de la tabla. Patrón de Regex: ^[A-Za-z0-9-_]+$
workspaceName	path	True	string	El nombre del área de trabajo. Patrón de Regex: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version	query	True	string	Versión de API que se usará para la 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	Retención de tabla en días, entre 4 y 730. Si establece esta propiedad en -1, el valor predeterminado será la retención del área de trabajo.
properties.schema	Schema	Esquema de la tabla
properties.searchResults	SearchResults	Parámetros del trabajo de búsqueda que inició esta tabla.
properties.totalRetentionInDays	integer	La retención total de la tabla en días, entre 4 y 4383. Si establece esta propiedad en -1, el valor predeterminado es 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 larga duración).
Other Status Codes	ErrorResponse	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo 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	suplantación de su 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=2023-09-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=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

Definiciones

Nombre	Description
Column	Columna de tabla.
ColumnDataTypeHintEnum	Sugerencia lógica de tipo de datos de columna.
ColumnTypeEnum	Tipo de datos de la 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 tabla.
systemData	Metadatos relacionados con la creación y la ú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 tabla.

Column

Columna de tabla.

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

ColumnDataTypeHintEnum

Sugerencia lógica de tipo de datos de columna.

Nombre	Tipo	Description
armPath	string	Ruta de acceso del modelo de recursos de Azure (ARM): /subscriptions/{...} /resourceGroups/{...} /providers/Microsoft. {...} /{...} /{...} /{...} ...
guid	string	GUID estándar de 128 bits después de la forma estándar, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ip	string	Una dirección IP V4/V6 estándar siguiendo la forma estándar, x.x.x.x/y:y:y:y:y:y:y:y:y
uri	string	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

Tipo de datos de la columna.

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

createdByType

Tipo de identidad que creó el recurso.

Nombre	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

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

Detalle del error.

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

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto 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.

Nombre	Tipo	Description
Deleting	string	El estado de la tabla se está eliminando.
InProgress	string	El esquema de tabla es estable y sin cambios, se actualizan los datos de la tabla.
Succeeded	string	El estado de la tabla es estable y sin cambios, la tabla se desbloquea y se abre para las nuevas actualizaciones.
Updating	string	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

Restaurar parámetros.

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

ResultStatistics

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

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

Schema

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 tabla.
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 tabla.

SearchResults

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

Nombre	Tipo	Description
azureAsyncOperationId	string	Identificador de la operación asincrónica de la tabla de resultados de la búsqueda.
description	string	Descripción del trabajo de búsqueda.
endSearchTime	string	Marca de tiempo para finalizar la búsqueda por (UTC)
limit	integer	Limite el trabajo de búsqueda para que devuelva 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	Marca de tiempo para iniciar la búsqueda desde (UTC)

SourceEnum

Creador de la tabla.

Nombre	Tipo	Description
customer	string	Tablas creadas por el propietario del área de trabajo y que solo se encuentran en esta área de trabajo.
microsoft	string	Tablas aprovisionadas por el sistema, tal 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

Metadatos relacionados con la creación y la última modificación del recurso.

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

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

Nombre	Tipo	Description
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso.
properties.archiveRetentionInDays	integer	Retención del archivo de datos de tabla en días. Se calcula como (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	La 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	Retención de la tabla en días, entre 4 y 730. Al establecer esta propiedad en -1, el valor predeterminado será 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 la tabla
properties.searchResults	SearchResults	Parámetros del trabajo de búsqueda que inició esta tabla.
properties.totalRetentionInDays	integer	La retención total de la tabla en días, entre 4 y 4383. Si se establece esta propiedad en -1, el valor predeterminado es la retención de tablas.
properties.totalRetentionInDaysAsDefault	boolean	True: el valor se origina en la retención en días, False: específico del cliente.
systemData	systemData	Metadatos relacionados con la creación y la última modificación del recurso.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TablePlanEnum

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

Nombre	Tipo	Description
Analytics	string	Registros que permiten la supervisión y el análisis.
Basic	string	Registros ajustados para admitir registros detallados de bajo valor de gran volumen.

TableSubTypeEnum

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

Nombre	Tipo	Description
Any	string	Subtipo predeterminado con el que se crean las tablas integradas.
Classic	string	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 en la que se crearon campos personalizados.
DataCollectionRuleBased	string	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

Creador de la tabla.

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