Поделиться через

Tables - Update

Служба:
Log Analytics
Версия API:
2025-07-01

Обновите таблицу рабочей области Log Analytics.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2025-07-01

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId
 path True

string

minLength: 1

Идентификатор целевой подписки.
tableName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9-_]+$

Название таблицы.
workspaceName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Имя рабочей области.
api-version
 query True

string

minLength: 1

Версия API, используемая для данной операции.

Текст запроса

Имя Тип Описание
properties.plan

TablePlanEnum

Укажите системе, как обрабатывать и взимать плату за журналы, входящие в эту таблицу.
properties.restoredLogs

RestoredLogs

Параметры операции восстановления, инициируемой этой таблицей.
properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

В таблице Analytics — хранение таблиц аналитики в днях, от 4 до 730. Если для этого свойства задано значение -1 по умолчанию будет сохраняться рабочая область. В основной и вспомогательной таблицах: свойство только для чтения.
properties.schema

Schema

Схема таблицы.
properties.searchResults

SearchResults

Параметры задания поиска, инициирующего эту таблицу.
properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 4383

Общее хранение таблицы в днях от 4 до 4383. Если задать для этого свойства значение -1 по умолчанию будет установлено значение retentionInDays.

Ответы

Имя Тип Описание
200 OK

Table

OK определение ответа.
202 Accepted

Принятое определение ответа (Long running operation).
Other Status Codes

ErrorResponse

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

TablesUpsert

Образец запроса

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow?api-version=2025-07-01

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid"
        }
      ]
    },
    "retentionInDays": 45,
    "totalRetentionInDays": 70
  }
}

Пример ответа

Код состояния:
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"
}
Код состояния:
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-07-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-07-01

Определения

Имя Описание
Column

Столбец таблицы.
ColumnDataTypeHintEnum

Логическое указание типа данных столбца.
ColumnTypeEnum

Тип данных столбца.
createdByType

Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail

Сведения об ошибке.
ErrorResponse

Ответ на ошибку
ProvisioningStateEnum

Текущее состояние подготовки таблицы. Если установлено значение 'updating', указывает на блокировку ресурса из-за текущей операции, запрещая любое обновление таблицы до тех пор, пока текущая операция не будет завершена.
RestoredLogs

Восстановите параметры.
ResultStatistics

Статистика выполнения задания поиска.
Schema

Схема таблицы.
SearchResults

Параметры задания поиска, инициирующего эту таблицу.
SourceEnum

Создатель стола.
systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.
Table

Определение таблицы данных рабочей области.
TablePlanEnum

Укажите системе, как обрабатывать и взимать плату за журналы, входящие в эту таблицу.
TableSubTypeEnum

Подтип описывает, какие API можно использовать для взаимодействия с таблицей и какие функции доступны для нее.
TableTypeEnum

Создатель стола.

Column

Объект

Столбец таблицы.

Имя Тип Описание
dataTypeHint

ColumnDataTypeHintEnum

Логическое указание типа данных столбца.
description

string

Описание столбца.
displayName

string

Отображаемое имя столбца.
isDefaultDisplay

boolean

Отображается по умолчанию.
isHidden

boolean

Является ли столбец скрытым.
name

string

Имя столбца.
type

ColumnTypeEnum

Тип данных столбца.

ColumnDataTypeHintEnum

Перечисление

Логическое указание типа данных столбца.

Значение Описание
uri

Строка, соответствующая шаблону URI, например scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment
guid

Стандартный 128-разрядный GUID в соответствии со стандартной формой, xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx
armPath

Путь к модели ресурсов Azure (ARM): /subscriptions/{...}/resourceGroups/{...}/провайдеры/Майкрософт. {...}/{...}/{...}/{...}...
ip

Стандартный ip-адрес V4/V6 в соответствии со стандартной формой, x.x.x.x/y:y:y:y:y:y

ColumnTypeEnum

Перечисление

Тип данных столбца.

Значение Описание
string
int
long
real
boolean
dateTime
guid
dynamic

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

ProvisioningStateEnum

Перечисление

Текущее состояние подготовки таблицы. Если установлено значение 'updating', указывает на блокировку ресурса из-за текущей операции, запрещая любое обновление таблицы до тех пор, пока текущая операция не будет завершена.

Значение Описание
Updating

Схема таблицы все еще строится и обновляется, таблица в настоящее время заблокирована для любых изменений до тех пор, пока процедура не будет завершена.
InProgress

Схема таблицы стабильна и без изменений, данные таблицы обновляются.
Succeeded

Состояние таблицы стабильное и без изменений, таблица разблокирована и открыта для новых обновлений.
Deleting

Состояние таблицы удаляется.

RestoredLogs

Объект

Восстановите параметры.

Имя Тип Описание
azureAsyncOperationId

string

Идентификатор асинхронной операции таблицы результатов поиска.
endRestoreTime

string (date-time)

Метка времени для завершения восстановления (UTC).
sourceTable

string

Таблица для восстановления данных из.
startRestoreTime

string (date-time)

Метка времени для запуска восстановления из (UTC).

ResultStatistics

Объект

Статистика выполнения задания поиска.

Имя Тип Описание
ingestedRecords

integer (int32)

Количество строк, возвращенных заданием поиска.
progress

number

multipleOf: 0.01

Процент выполнения заданий в поиске.
scannedGb

number

multipleOf: 0.01

Задание поиска: объем отсканированных данных.

Schema

Объект

Схема таблицы.

Имя Тип Описание
categories

string[]

Категория стола.
columns

Column[]

Список настраиваемых столбцов таблицы.
description

string

Описание таблицы.
displayName

string

Отображаемое имя таблицы.
labels

string[]

Табличные этикетки.
name

string

Имя таблицы.
solutions

string[]

Список решений, с которыми связан стол
source

SourceEnum

Создатель стола.
standardColumns

Column[]

Список стандартных столбцов таблицы.
tableSubType

TableSubTypeEnum

Подтип описывает, какие API можно использовать для взаимодействия с таблицей и какие функции доступны для нее.
tableType

TableTypeEnum

Создатель стола.

SearchResults

Объект

Параметры задания поиска, инициирующего эту таблицу.

Имя Тип Описание
azureAsyncOperationId

string

Идентификатор асинхронной операции таблицы результатов поиска.
description

string

Описание задания поиска.
endSearchTime

string (date-time)

Метка времени для завершения поиска по (UTC)
limit

integer (int32)

Ограничьте задание поиска, чтобы вернуться до указанного количества строк.
query

string

Запрос задания поиска.
sourceTable

string

Таблица, используемая в задании поиска.
startSearchTime

string (date-time)

Метка времени для запуска поиска из (UTC)

SourceEnum

Перечисление

Создатель стола.

Значение Описание
microsoft

Таблицы, предоставленные системой и собранные с помощью настроек диагностики, агентов или любых других стандартных средств сбора данных.
customer

Таблицы, созданные владельцем рабочей области и найденные только в этой рабочей области.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).
createdBy

string

Удостоверение, создающее ресурс.
createdByType

createdByType

Тип удостоверения, создавшего ресурс.
lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)
lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.
lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.

Table

Объект

Определение таблицы данных рабочей области.

Имя Тип Описание
id

string

Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

Имя ресурса
properties.archiveRetentionInDays

integer (int32)

Таблицы долгосрочного хранения в днях. Рассчитывается как (totalRetentionInDays-retentionInDays).
properties.lastPlanModifiedDate

string

Временная метка этого плана таблицы была изменена в последний раз (UTC).
properties.plan

TablePlanEnum

Укажите системе, как обрабатывать и взимать плату за журналы, входящие в эту таблицу.
properties.provisioningState

ProvisioningStateEnum

Текущее состояние подготовки таблицы. Если установлено значение 'updating', указывает на блокировку ресурса из-за текущей операции, запрещая любое обновление таблицы до тех пор, пока текущая операция не будет завершена.
properties.restoredLogs

RestoredLogs

Параметры операции восстановления, инициируемой этой таблицей.
properties.resultStatistics

ResultStatistics

Статистика выполнения задания поиска.
properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

В таблице Analytics — хранение таблиц аналитики в днях, от 4 до 730. Если для этого свойства задано значение -1 по умолчанию будет сохраняться рабочая область. В основной и вспомогательной таблицах: свойство только для чтения.
properties.retentionInDaysAsDefault

boolean

True — значение зависит от удержания рабочей области в днях, False — зависит от клиента.
properties.schema

Schema

Схема таблицы.
properties.searchResults

SearchResults

Параметры задания поиска, инициирующего эту таблицу.
properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 4383

Общее хранение таблицы в днях от 4 до 4383. Если задать для этого свойства значение -1 по умолчанию будет установлено значение retentionInDays.
properties.totalRetentionInDaysAsDefault

boolean

True — значение возникает на основе удержания в днях, False — зависит от клиента.
systemData

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.
type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

TablePlanEnum

Перечисление

Укажите системе, как обрабатывать и взимать плату за журналы, входящие в эту таблицу.

Значение Описание
Basic

Журналы среднего доступа, необходимые для устранения неполадок и реагирования на инциденты.
Analytics

Ценные журналы, используемые для непрерывного мониторинга, обнаружения в режиме реального времени и анализа производительности.
Auxiliary

Журналы, к которым не требуется прикладываться, такие как подробные журналы, и данные, необходимые для аудита и соответствия требованиям.

TableSubTypeEnum

Перечисление

Подтип описывает, какие API можно использовать для взаимодействия с таблицей и какие функции доступны для нее.

Значение Описание
Any

Подтип по умолчанию, с помощью которого создаются встроенные таблицы.
Classic

Указывает на таблицу, созданную с помощью API сборщика данных или с помощью функции пользовательских журналов агента MMA, или любую таблицу, для которой были созданы настраиваемые поля.
DataCollectionRuleBased

Таблица, в которую могут быть отправлены данные с помощью любого из средств, поддерживаемых правилами сбора данных: API конечной точки сбора данных, преобразований времени приема или любого другого механизма, предусмотренного правилами сбора данных.

TableTypeEnum

Перечисление

Создатель стола.

Значение Описание
Microsoft

Стандартные данные, собираемые Azure Monitor.
CustomLog

Пользовательская таблица журналов.
RestoredLogs

Восстановленные данные.
SearchResults

Данные, собираемые поисковым заданием.