Get Recommendations - List

Layanan:

Sentinel

Versi API:

2025-10-01-preview

Mendapatkan daftar semua rekomendasi.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nama ruang kerja.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	RecommendationList	Operasi Azure berhasil diselesaikan.
Other Status Codes	CloudError	Respons kesalahan yang tidak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Get Recommendations list.

Permintaan sampel

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

Respon sampel

Kode status:

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

Definisi

Nama	Deskripsi
CloudError	Struktur respons kesalahan.
CloudErrorBody	Detail kesalahan.
createdByType	Jenis identitas yang membuat sumber daya tersebut.
Recommendation	Rekomendasi.
RecommendationList	Daftar rekomendasi
RecommendedSuggestion	Saran apa yang harus diambil untuk menyelesaikan rekomendasi.
State	Status rekomendasi.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

CloudError

Objek

Struktur respons kesalahan.

Nama	Jenis	Deskripsi
error	CloudErrorBody	Data kesalahan

CloudErrorBody

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya tersebut.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

Recommendation

Objek

Rekomendasi.

Nama	Jenis	Deskripsi
etag	string	Etag sumber daya azure
id	string (arm-id)	ID sumber daya lengkap untuk sumber daya tersebut. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya.
properties.additionalProperties	object	Kumpulan properti tambahan untuk rekomendasi.
properties.creationTimeUtc	string (date-time)	Stempel waktu (UTC) ketika rekomendasi dibuat.
properties.description	string	Deskripsi rekomendasi.
properties.lastEvaluatedTimeUtc	string (date-time)	Stempel waktu (UTC) ketika rekomendasi terakhir dievaluasi.
properties.lastModifiedTimeUtc	string (date-time)	Stempel waktu (UTC) ketika rekomendasi terakhir diubah.
properties.recommendationTypeId	string	Id jenis rekomendasi.
properties.resourceId	string	Id sumber daya yang dirujuk rekomendasi ini.
properties.state	State	Status rekomendasi.
properties.suggestions	RecommendedSuggestion[]	Daftar saran yang harus diambil untuk rekomendasi ini.
properties.title	string	Judul rekomendasi.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

RecommendationList

Objek

Daftar rekomendasi

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	Recommendation[]	Item Rekomendasi di halaman ini

RecommendedSuggestion

Objek

Saran apa yang harus diambil untuk menyelesaikan rekomendasi.

Nama	Jenis	Deskripsi
action	string	Tindakan saran.
additionalProperties	object	Kumpulan properti tambahan untuk saran.
description	string	Deskripsi saran.
suggestionTypeId	string	Id jenis saran.
title	string	Judul saran.

State

Enumerasi

Status rekomendasi.

Nilai	Deskripsi
Active	Rekomendasi aktif.
InProgress	Rekomendasi sedang berlangsung.
Dismissed	Rekomendasi telah diberhentikan.
CompletedByUser	Rekomendasi telah diselesaikan oleh pengguna.
CompletedBySystem	Rekomendasi telah diselesaikan oleh sistem.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya tersebut.
createdByType	createdByType	Jenis identitas yang membuat sumber daya tersebut.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir kali mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.