Get Recommendations - List

Hizmet:

Sentinel

API Sürümü:

2025-10-01-preview

Tüm önerilerin listesini alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/recommendations?api-version=2025-10-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Çalışma alanının adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	RecommendationList	Azure işlemi başarıyla tamamlandı.
Other Status Codes	CloudError	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

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ı taklit etme

Örnekler

Get Recommendations list.

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/recommendations?api-version=2025-10-01-preview

Örnek yanıt

Durum kodu:

200

{
  "value": [
    {
      "name": "ceea048e-923e-4eeb-8fcb-6cb0c06b101f",
      "type": "Microsoft.SecurityInsights/Recommendations",
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Recommendations/ceea048e-923e-4eeb-8fcb-6cb0c06b101f",
      "properties": {
        "description": "someText",
        "additionalProperties": {
          "someKey": "someValue"
        },
        "creationTimeUtc": "2022-02-19T03:09:03.4888396+00:00",
        "lastEvaluatedTimeUtc": "2022-02-19T03:09:03.4888396+00:00",
        "lastModifiedTimeUtc": "2022-02-19T03:57:31.7964447+00:00",
        "recommendationTypeId": "ThreatIntelligence_Example",
        "resourceId": "someId",
        "state": "CompletedBySystem",
        "suggestions": [
          {
            "description": "someText",
            "action": "someText",
            "additionalProperties": {
              "someKey": "someValue"
            },
            "suggestionTypeId": "ThreatIntelligence_Example_Suggestion_Example",
            "title": "someText"
          }
        ],
        "title": "someText"
      }
    }
  ]
}

Tanımlar

Name	Description
CloudError	Hata yanıtı yapısı.
CloudErrorBody	Hata ayrıntıları.
createdByType	Kaynağı oluşturan kimliğin türü.
Recommendation	Öneri nesnesi.
RecommendationList	Önerilerin listesi
RecommendedSuggestion	Öneriyi tamamlamak için hangi önerilerin alınması gerekir?
State	Tavsiye durumu.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

CloudError

Nesne

Hata yanıtı yapısı.

Name	Tür	Description
error	CloudErrorBody	Hata verileri

CloudErrorBody

Nesne

Hata ayrıntıları.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	string	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

Recommendation

Nesne

Öneri nesnesi.

Name	Tür	Description
etag	string	Azure kaynağının etag'i
id	string (arm-id)	Kaynağın tam nitelikli kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.additionalProperties	object	Öneri için ek özellikler koleksiyonu.
properties.creationTimeUtc	string (date-time)	Önerinin oluşturulduğu zaman damgası (UTC).
properties.description	string	Önerinin açıklaması.
properties.lastEvaluatedTimeUtc	string (date-time)	Önerinin en son değerlendirildiği zaman damgası (UTC).
properties.lastModifiedTimeUtc	string (date-time)	Önerinin en son değiştirildiği zaman damgası (UTC).
properties.recommendationTypeId	string	Öneri türünün kimliği.
properties.resourceId	string	Bu önerinin başvurduğu kaynağın kimliği.
properties.state	State	Önerinin durumu.
properties.suggestions	RecommendedSuggestion[]	Bu öneri için alınması gereken önerilerin listesi.
properties.title	string	Önerinin başlığı.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

RecommendationList

Nesne

Önerilerin listesi

Name	Tür	Description
nextLink	string (uri)	Öğelerin sonraki sayfasına bağlantı
value	Recommendation[]	Bu sayfadaki Tavsiye maddeleri

RecommendedSuggestion

Nesne

Öneriyi tamamlamak için hangi önerilerin alınması gerekir?

Name	Tür	Description
action	string	Önerinin eylemi.
additionalProperties	object	Öneri için ek özellikler koleksiyonu.
description	string	Önerinin açıklaması.
suggestionTypeId	string	Öneri türünün kimliği.
title	string	Önerinin başlığı.

State

Numaralandırma

Tavsiye durumu.

Değer	Description
Active	Öneri etkin.
InProgress	Öneri devam ediyor.
Dismissed	Öneri kapatıldı.
CompletedByUser	Öneri kullanıcı tarafından tamamlandı.
CompletedBySystem	Öneri sistem tarafından tamamlandı.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturmanın zaman damgası (UTC).
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.