Summary Logs - Get

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

Получает сводные правила рабочей области Log Analytics.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/summaryLogs/{summaryLogsName}?api-version=2026-03-01

Параметры URI

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

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя нечувствительно к регистру.
subscriptionId
 path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
summaryLogsName
 path True

string

pattern: [^/]+

Имя сводных журналов. Не должен содержать '/'.
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, используемая для данной операции.

Ответы

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

SummaryLogs

Операция Azure успешно завершена.
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

Имя Описание
user_impersonation выдать себя за учетную запись пользователя

Примеры

SummaryLogsGet

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

GET https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/summaryLogs/summarylogs1?api-version=2026-03-01

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

Код состояния:
200 
{
  "name": "summarylogs1",
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/summaryLogs/summarylogs1",
  "properties": {
    "isActive": false,
    "provisioningState": "Succeeded",
    "ruleDefinition": {
      "binDelay": 10,
      "binSize": 180,
      "binStartTime": "2020-02-03T04:05:06Z",
      "destinationTable": "MyDestinationTable_CL",
      "query": "MyTable_CL"
    },
    "ruleType": "User",
    "statusCode": "UserAction"
  },
  "systemData": {
    "createdAt": "2020-02-03T04:05:06Z",
    "createdBy": "22222222-2222-2222-2222-222222222222"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {
        "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
        "clientId": "11111111-1111-1111-1111-111111111111"
      }
    }
  }
}

Определения

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

Тип учётной записи, создавшей ресурс.
ErrorAdditionalInfo

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

Подробности ошибки.
ErrorResponse

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

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

Параметры определения правил.
RuleTypeEnum

Тип правила SummaryRules: Пользователь.
StatusCodeEnum

Указывает причину деактивации правила.
SummaryLogs

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

Идентичность ресурса журналов сводки.
SummaryLogsIdentityType

Тип управляемого удостоверения службы.
SummaryLogsUserIdentityProperties

Свойства назначаемого пользователем удостоверения.
systemData

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

Курсор времени, используемый при обработке бинов правил Summary, например, TimeGenerated.

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

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

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

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

Состояние таблицы не выполнено.
Canceled

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

RuleDefinition

Объект

Параметры определения правил.

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

integer (int32)

Минимальная задержка в секундах перед обработкой ячейки.
binSize

integer (int32)

Запланированное окно в минутах. Допустимые значения: 20, 30, 60, 120, 180, 360, 720, 1440.
binStartTime

string (date-time)

Время начала (UTC) начала выполнения сводного правила.
destinationTable

string

Конечная таблица, используемая для результатов правила Сумма.
query

string

Запрос сводного правила.
timeSelector

TimeSelectorEnum

Курсор времени, используемый при обработке бинов правил Summary, например, TimeGenerated.

RuleTypeEnum

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

Тип правила SummaryRules: Пользователь.

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

Определяемое пользователем суммарное правило. Это определение правил, создаваемых и определяемых пользователями.

StatusCodeEnum

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

Указывает причину деактивации правила.

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

Остановка сводного правила возникает в результате действия пользователя (вызывается Stop).
DataPlaneError

Остановка сводного правила была вызвана ошибкой, связанной с плоскостью данных.

SummaryLogs

Объект

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

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

string (arm-id)

Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity

SummaryLogsIdentity

Управляемая идентичность ресурса сводных журналов. Поддерживается только идентификация, назначенная пользователем.
name

string

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

string

Описание правила Суммарная версия.
properties.displayName

string

Отображаемое имя правила Сводка.
properties.isActive

boolean

Указывает, активно ли правило суммирования. В противном случае выполнение правила Summary останавливается.
properties.provisioningState

ProvisioningStateEnum

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

RuleDefinition

Параметры определения правил.
properties.ruleType

RuleTypeEnum

Тип правила SummaryRules: Пользователь.
properties.statusCode

StatusCodeEnum

Указывает причину деактивации правила.
systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type

string

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

SummaryLogsIdentity

Объект

Идентичность ресурса журналов сводки.

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

string

Идентификатор субъекта удостоверения ресурса.
tenantId

string

Идентификатор клиента ресурса.
type

SummaryLogsIdentityType

Тип управляемого удостоверения службы.
userAssignedIdentities

<string,  SummaryLogsUserIdentityProperties>

Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

SummaryLogsIdentityType

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

Тип управляемого удостоверения службы.

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

Тип идентичности по умолчанию. Журналы сводки не имеют управляемой идентичности.
UserAssigned

Журналы сводки связаны с управляемой идентичностью, назначенной пользователем. Идентификаторы, назначенные пользователем, создаются как отдельные ресурсы Azure и могут использоваться в нескольких журналах сводки.

SummaryLogsUserIdentityProperties

Объект

Свойства назначаемого пользователем удостоверения.

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

string

Идентификатор клиента назначаемого пользователем удостоверения.
principalId

string

Идентификатор субъекта назначаемого пользователем удостоверения.

systemData

Объект

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

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

string (date-time)

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

string

Идентификатор, создавший ресурс.
createdByType

createdByType

Тип учётной записи, создавшей ресурс.
lastModifiedAt

string (date-time)

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

string

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

createdByType

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

TimeSelectorEnum

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

Курсор времени, используемый при обработке бинов правил Summary, например, TimeGenerated.

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

TimeGenerated.