Saved Searches - Create Or Update
Belirli bir çalışma alanı için kaydedilmiş bir arama oluşturur veya güncelleştirir.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/savedSearches/{savedSearchId}?api-version=2020-08-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir. |
saved
|
path | True |
string |
Kaydedilen aramanın kimliği. |
subscription
|
path | True |
string |
Hedef aboneliğin kimliği. |
workspace
|
path | True |
string |
Çalışma alanının adı. Normal ifade deseni: |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
properties.category | True |
string |
Kaydedilen aramanın kategorisi. Bu, kullanıcının kaydedilmiş bir aramayı daha hızlı bulmasına yardımcı olur. |
properties.displayName | True |
string |
Kaydedilen arama görünen adı. |
properties.query | True |
string |
Kaydedilen aramanın sorgu ifadesi. |
etag |
string |
Kaydedilen aramanın ETag'i. Mevcut kaydedilmiş aramayı geçersiz kılmak için "*" kullanın veya geçerli Etag'i belirtin |
|
properties.functionAlias |
string |
Sorgu bir işlev işlevi görürse işlev diğer adı. |
|
properties.functionParameters |
string |
Sorgu bir işlev işlevi görecekse isteğe bağlı işlev parametreleri. Değer şu biçimde olmalıdır: 'param-name1:type1 = default_value1, param-name2:type2 = default_value2'. Daha fazla örnek ve doğru söz dizimi için bkz https://docs.microsoft.com/en-us/azure/kusto/query/functions/user-defined-functions. . |
|
properties.tags |
Tag[] |
Kaydedilen aramaya eklenen etiketler. |
|
properties.version |
integer |
Sorgu dilinin sürüm numarası. Geçerli sürüm 2'dir ve varsayılan sürümdür. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam yanıt tanımı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
SavedSearchCreateOrUpdate
Örnek isteği
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=2020-08-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"
}
]
}
}
Örnek yanıt
{
"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
}
}
Tanımlar
Name | Description |
---|---|
Saved |
Kaydedilen arama sonuçları için değer nesnesi. |
Tag |
Kaydedilen aramanın etiketi. |
SavedSearch
Kaydedilen arama sonuçları için değer nesnesi.
Name | Tür | Description |
---|---|---|
etag |
string |
Kaydedilen aramanın ETag'i. Mevcut kaydedilmiş aramayı geçersiz kılmak için "*" kullanın veya geçerli Etag'i belirtin |
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Kaynağın adı |
properties.category |
string |
Kaydedilen aramanın kategorisi. Bu, kullanıcının kaydedilmiş bir aramayı daha hızlı bulmasına yardımcı olur. |
properties.displayName |
string |
Kaydedilen arama görünen adı. |
properties.functionAlias |
string |
Sorgu bir işlev işlevi görürse işlev diğer adı. |
properties.functionParameters |
string |
Sorgu bir işlev işlevi görecekse isteğe bağlı işlev parametreleri. Değer şu biçimde olmalıdır: 'param-name1:type1 = default_value1, param-name2:type2 = default_value2'. Daha fazla örnek ve doğru söz dizimi için bkz https://docs.microsoft.com/en-us/azure/kusto/query/functions/user-defined-functions. . |
properties.query |
string |
Kaydedilen aramanın sorgu ifadesi. |
properties.tags |
Tag[] |
Kaydedilen aramaya eklenen etiketler. |
properties.version |
integer |
Sorgu dilinin sürüm numarası. Geçerli sürüm 2'dir ve varsayılan sürümdür. |
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
Tag
Kaydedilen aramanın etiketi.
Name | Tür | Description |
---|---|---|
name |
string |
Etiket adı. |
value |
string |
Etiket değeri. |