Saved Searches - Get

Служба:: Log Analytics

Версия API:: 2026-03-01

Получает указанный сохраненный поиск для заданного рабочего пространства.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя нечувствительно к регистру.
savedSearchId	path	True	string	Идентификатор сохраненного поиска.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
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	SavedSearch	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

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

Примеры

SavedSearchesGet

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

HTTP

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

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

Код состояния:: 200

{
  "etag": "W/\"datetime'2017-10-02T23%3A15%3A41.0709875Z'\"",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/workspaces/AtlantisDemo/savedSearches/test-new-saved-search-id-2015",
  "properties": {
    "category": " Saved Search Test Category",
    "displayName": "Create or Update Saved Search Test",
    "functionAlias": "heartbeat_func",
    "functionParameters": "a:int=1",
    "query": "* | measure Count() by Computer | take a",
    "version": 1
  }
}

Определения

Имя	Описание
createdByType	Тип учётной записи, создавшей ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Подробности ошибки.
ErrorResponse	Ответ на ошибку
SavedSearch	Объект Value для сохраненных результатов поиска.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
Tag	Тег сохраненного поиска.

createdByType

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

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

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

ErrorAdditionalInfo

Объект

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

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Объект

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

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

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

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

SavedSearch

Объект

Объект Value для сохраненных результатов поиска.

Имя	Тип	Описание
etag	string	ETag сохраненного поиска. Чтобы переопределить существующий сохраненный поиск, используйте "*" или укажите текущий Etag
id	string (arm-id)	Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса.
properties.category	string	Категория сохраненного поиска. Это помогает пользователю быстрее найти сохраненный поиск.
properties.displayName	string	Сохраненное отображаемое имя поиска.
properties.functionAlias	string	Псевдоним функции, если запрос служит функцией.
properties.functionParameters	string	Необязательные параметры функции, если запрос служит функцией. Значение должно быть в следующем формате: "param-name1:type1 = default_value1, param-name2:type2 = default_value2". Дополнительные примеры и правильный синтаксис см. в https://docs.microsoft.com/en-us/azure/kusto/query/functions/user-defined-functions.
properties.query	string	Выражение запроса для сохраненного поиска.
properties.tags	Tag[]	Теги, присоединенные к сохраненному поиску.
properties.version	integer (int64)	Номер версии языка запросов. Текущая версия — 2 и используется по умолчанию.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

systemData

Объект

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

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Идентификатор, создавший ресурс.
createdByType	createdByType	Тип учётной записи, создавшей ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Tag

Объект

Тег сохраненного поиска.

Имя	Тип	Описание
name	string	Имя тега.
value	string	Значение тега.