Saved Searches - Create Or Update

서비스:

Log Analytics

API 버전:

2023-09-01

지정된 작업 영역에 대한 저장된 검색을 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/savedSearches/{savedSearchId}?api-version=2023-09-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.
savedSearchId	path	True	string	저장된 검색의 ID입니다.
subscriptionId	path	True	string	대상 구독의 ID입니다.
workspaceName	path	True	string	작업 영역의 이름 regex 패턴: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
properties.category	True	string	저장된 검색의 범주입니다. 이렇게 하면 사용자가 저장된 검색을 더 빠르게 찾을 수 있습니다.
properties.displayName	True	string	저장된 검색 표시 이름입니다.
properties.query	True	string	저장된 검색에 대한 쿼리 식입니다.
etag		string	저장된 검색의 ETag입니다. 기존 저장된 검색을 재정의하려면 "*"를 사용하거나 현재 Etag를 지정합니다.
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.tags		Tag[]	저장된 검색에 연결된 태그입니다.
properties.version		integer	쿼리 언어의 버전 번호입니다. 현재 버전은 2이며 기본값입니다.

응답

Name	형식	Description
200 OK	SavedSearch	확인 응답 정의입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

SavedSearchCreateOrUpdate

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/TestRG/providers/Microsoft.OperationalInsights/workspaces/TestWS/savedSearches/00000000-0000-0000-0000-00000000000?api-version=2023-09-01

{
  "properties": {
    "category": "Saved Search Test Category",
    "displayName": "Create or Update Saved Search Test",
    "version": 2,
    "functionAlias": "heartbeat_func",
    "functionParameters": "a:int=1",
    "query": "Heartbeat | summarize Count() by Computer | take a",
    "tags": [
      {
        "name": "Group",
        "value": "Computer"
      }
    ]
  }
}

샘플 응답

상태 코드:

200

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

정의

Name	Description
SavedSearch	저장된 검색 결과에 대한 값 개체입니다.
Tag	저장된 검색의 태그입니다.

SavedSearch

저장된 검색 결과에 대한 값 개체입니다.

Name	형식	Description
etag	string	저장된 검색의 ETag입니다. 기존 저장된 검색을 재정의하려면 "*"를 사용하거나 현재 Etag를 지정합니다.
id	string	리소스에 대한 정규화된 리소스 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	쿼리 언어의 버전 번호입니다. 현재 버전은 2이며 기본값입니다.
type	string	리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

Tag

저장된 검색의 태그입니다.

Name	형식	Description
name	string	태그 이름입니다.
value	string	태그 값입니다.