Saved Searches - Create Or Update

Reference

Služba:: Log Analytics

Verze rozhraní API:: 2023-09-01

Vytvoří nebo aktualizuje uložené hledání pro daný pracovní prostor.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.
savedSearchId	path	True	string	ID uloženého hledání.
subscriptionId	path	True	string	ID cílového předplatného.
workspaceName	path	True	string	Název pracovního prostoru. Vzor regulárního výrazu: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
properties.category	True	string	Kategorie uloženého hledání. To uživateli pomůže rychleji najít uložené hledání.
properties.displayName	True	string	Uložili jsme zobrazované jméno hledání.
properties.query	True	string	Výraz dotazu pro uložené hledání.
etag		string	Značka ETag uloženého hledání. Pokud chcete přepsat existující uložené hledání, použijte "*" nebo zadejte aktuální etag.
properties.functionAlias		string	Alias funkce, pokud dotaz slouží jako funkce.
properties.functionParameters		string	Volitelné parametry funkce, pokud dotaz slouží jako funkce. Hodnota by měla být v následujícím formátu: "název_parametru1:typ1 = default_value1, název_parametru2:typ2 = default_value2". Další příklady a správnou syntaxi najdete v tématu https://docs.microsoft.com/en-us/azure/kusto/query/functions/user-defined-functions.
properties.tags		Tag[]	Značky připojené k uloženému hledání.
properties.version		integer	Číslo verze dotazovacího jazyka. Aktuální verze je 2 a je výchozí.

Odpovědi

Name	Typ	Description
200 OK	SavedSearch	Definice odpovědi OK.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

SavedSearchCreateOrUpdate

Ukázkový požadavek

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"
      }
    ]
  }
}

Ukázková odpověď

Stavový kód:: 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
  }
}

Definice

Name	Description
SavedSearch	Objekt Value pro uložené výsledky hledání.
Tag	Značka uloženého hledání.

SavedSearch

Objekt Value pro uložené výsledky hledání.

Name	Typ	Description
etag	string	Značka ETag uloženého hledání. Pokud chcete přepsat existující uložené hledání, použijte "*" nebo zadejte aktuální etag.
id	string	Plně kvalifikované ID prostředku. Příklad – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Název prostředku
properties.category	string	Kategorie uloženého hledání. To uživateli pomůže rychleji najít uložené hledání.
properties.displayName	string	Uložili jsme zobrazované jméno hledání.
properties.functionAlias	string	Alias funkce, pokud dotaz slouží jako funkce.
properties.functionParameters	string	Volitelné parametry funkce, pokud dotaz slouží jako funkce. Hodnota by měla být v následujícím formátu: "název_parametru1:typ1 = default_value1, název_parametru2:typ2 = default_value2". Další příklady a správnou syntaxi najdete v tématu https://docs.microsoft.com/en-us/azure/kusto/query/functions/user-defined-functions.
properties.query	string	Výraz dotazu pro uložené hledání.
properties.tags	Tag[]	Značky připojené k uloženému hledání.
properties.version	integer	Číslo verze dotazovacího jazyka. Aktuální verze je 2 a je výchozí.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

Tag

Značka uloženého hledání.

Name	Typ	Description
name	string	Název značky.
value	string	Hodnota značky.

Sdílet prostřednictvím