Tables - Get

Servicio:

Log Analytics

Versión de la API:

2026-03-01

Obtiene una tabla de área de trabajo de Log Analytics.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2026-03-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 distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
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.

Respuestas

Nombre	Tipo	Description
200 OK	Table	La operación de Azure se completó correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

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	suplantar su cuenta de usuario

Ejemplos

TablesGet

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH?api-version=2026-03-01

Respuesta de muestra

status code:

200

{
  "name": "table1_SRCH",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH",
  "properties": {
    "schema": {
      "name": "table1_SRCH",
      "description": null,
      "categories": null,
      "columns": [],
      "displayName": null,
      "labels": null,
      "solutions": [
        "LogManagement"
      ],
      "source": null,
      "standardColumns": [
        {
          "name": "TenantId",
          "type": "guid",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourceSystem",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "MG",
          "type": "guid",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "ManagementGroupName",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TimeGenerated",
          "type": "dateTime",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Computer",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "RawData",
          "type": "string",
          "description": null,
          "dataTypeHint": null,
          "displayName": null,
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "SearchResults"
    },
    "archiveRetentionInDays": 0,
    "plan": "Analytics",
    "provisioningState": "InProgress",
    "resultStatistics": {
      "ingestedRecords": 5,
      "progress": 75,
      "scannedGb": 23.5
    },
    "retentionInDays": 50,
    "retentionInDaysAsDefault": false,
    "searchResults": {
      "description": "This table was created using a Search Job with the following query: 'Heartbeat | where SourceSystem != '' | project SourceSystem'.",
      "endSearchTime": "2020-02-02T04:05:06Z",
      "limit": 1000,
      "query": "Heartbeat | where SourceSystem != '' | project SourceSystem",
      "sourceTable": "Heartbeat",
      "startSearchTime": "2020-02-03T04:05:06Z"
    },
    "totalRetentionInDays": 50,
    "totalRetentionInDaysAsDefault": true
  },
  "systemData": {
    "createdAt": "2020-02-03T04:05:06Z",
    "createdBy": "00000000-0000-0000-0000-000000000000"
  }
}

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
OperationalInsightsTableProvisioningState	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 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.
TableProtectionLevelEnum	El nivel de protección de la mesa. Determina el comportamiento predeterminado de aislamiento del acceso a los datos.
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

Objeto

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. Puede establecerse en el momento de la creación; Tras la creación, las actualizaciones deben coincidir con el nombre de la columna o ponerse en nulo/vacío. Si no se proporciona, por defecto el nombre de la columna.
isDefaultDisplay	boolean	Se muestra de forma predeterminada.
isHidden	boolean	Es la columna oculta.
name	string	Nombre de la columna.
type	ColumnTypeEnum	Tipo de datos de columna.

ColumnDataTypeHintEnum

Enumeración

Sugerencia lógica de tipo de datos de columna.

Valor	Description
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
guid	UN GUID estándar de 128 bits después de la forma estándar, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
armPath	Ruta de acceso del modelo de recursos de Azure (ARM): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
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
vector16	Un vector de valores de punto flotante de precisión simple utilizado para búsqueda semántica / de similitud.

ColumnTypeEnum

Enumeración

Tipo de datos de columna.

Valor	Description
string	string
int	int
long	long
real	real
boolean	booleano
dateTime	fecha y hora
guid	guid
dynamic	dynamic

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

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

Objeto

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	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

OperationalInsightsTableProvisioningState

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
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.
InProgress	El esquema de la tabla es estable y, sin cambios, los datos de la tabla se actualizan.
Succeeded	El estado de la tabla es estable y sin cambios, la tabla se desbloquea y se abre para las nuevas actualizaciones.
Deleting	El estado de la tabla es eliminar.

RestoredLogs

Objeto

Restaurar parámetros.

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

Objeto

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 (float)	Porcentaje de finalización del trabajo de búsqueda.
scannedGb	number (float)	Trabajo de búsqueda: cantidad de datos escaneados.

Schema

Objeto

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

Objeto

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

Nombre	Tipo	Description
azureAsyncOperationId	string	Identificador 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 tabla.

Valor	Description
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.
customer	Tablas creadas por el propietario del área de trabajo y que solo se encuentran en esta área de trabajo.

systemData

Objeto

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	La 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	La identidad que modificó el recurso por última vez.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Table

Objeto

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

Nombre	Tipo	Description
id	string (arm-id)	Identificador completamente cualificado del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso.
properties.archiveRetentionInDays	integer (int32)	Las tablas retención a largo plazo 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.protectionLevel	TableProtectionLevelEnum	El nivel de protección de la mesa. Determina el comportamiento predeterminado de aislamiento del acceso a los datos.
properties.provisioningState	OperationalInsightsTableProvisioningState	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	En la tabla Analytics: las tablas analizan la retención 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. En la tabla básica y auxiliar: propiedad de solo lectura.
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. Si se establece esta propiedad en -1, se establecerá de forma predeterminada retentionInDays.
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 de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de 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
Basic	Registros de contacto medio necesarios para la resolución de problemas y la respuesta a incidentes.
Analytics	Registros de alto valor utilizados para la supervisión continua, la detección en tiempo real y el análisis de rendimiento.
Auxiliary	Registros de bajo contacto, como registros detallados, y datos necesarios para la auditoría y el cumplimiento.

TableProtectionLevelEnum

Enumeración

El nivel de protección de la mesa. Determina el comportamiento predeterminado de aislamiento del acceso a los datos.

Valor	Description
General	El nivel de protección por defecto. Los datos de las tablas son accesibles mediante permisos estándar.
Protected	Los datos de la tabla están aislados por defecto. Acceder o exportar datos requiere una autorización explícita y con alcance.

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

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