Get Recommendations - List

참조

서비스:: Sentinel

API 버전:: 2025-01-01-preview

모든 권장 사항의 목록을 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
subscriptionId	path	True	string uuid	대상 구독의 ID입니다. 값은 UUID여야 합니다.
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
200 OK	RecommendationList	그래
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Get Recommendations list.

샘플 요청

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-01-01-preview

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Recommendations/ceea048e-923e-4eeb-8fcb-6cb0c06b101f",
      "name": "ceea048e-923e-4eeb-8fcb-6cb0c06b101f",
      "type": "Microsoft.SecurityInsights/Recommendations",
      "properties": {
        "recommendationTypeId": "ThreatIntelligence_Example",
        "state": "CompletedBySystem",
        "title": "someText",
        "description": "someText",
        "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",
        "suggestions": [
          {
            "suggestionTypeId": "ThreatIntelligence_Example_Suggestion_Example",
            "title": "someText",
            "description": "someText",
            "action": "someText",
            "additionalProperties": {
              "someKey": "someValue"
            }
          }
        ],
        "resourceId": "someId",
        "additionalProperties": {
          "someKey": "someValue"
        }
      }
    }
  ]
}

정의

Name	Description
CloudError	오류 응답 구조입니다.
CloudErrorBody	오류 세부 정보입니다.
createdByType	리소스를 만든 ID의 형식입니다.
Recommendation	Recommendation 개체입니다.
RecommendationList	권장 사항 목록
RecommendedSuggestion	권장 사항을 완료하기 위해 수행해야 하는 제안 사항입니다.
State	권장 사항의 상태입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

CloudError

오류 응답 구조입니다.

Name	형식	Description
error	CloudErrorBody	오류 데이터

CloudErrorBody

오류 세부 정보입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Recommendation

Recommendation 개체입니다.

Name	형식	Description
etag	string	Azure 리소스의 Etag
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties.additionalProperties	object	권장 사항에 대한 추가 속성의 컬렉션입니다.
properties.creationTimeUtc	string	권장 사항이 생성되었을 때의 타임스탬프를 나타냅니다.
properties.description	string	권장 사항에 대한 설명입니다.
properties.lastEvaluatedTimeUtc	string	권장 사항이 마지막으로 평가된 시간 스탬프(UTC)입니다.
properties.lastModifiedTimeUtc	string	권장 사항이 마지막으로 수정된 시간(UTC)입니다.
properties.recommendationTypeId	string	권장 사항 유형의 ID입니다.
properties.resourceId	string	이 권장 사항이 참조하는 리소스의 ID입니다.
properties.state	State	권장 사항의 상태입니다.
properties.suggestions	RecommendedSuggestion[]	이 권장 사항에 사용할 제안 목록입니다.
properties.title	string	권장 사항의 제목입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

RecommendationList

권장 사항 목록

Name	형식	Description
nextLink	string	리소스의 다음 페이지에 연결합니다.
value	Recommendation[]	권장 사항 목록

RecommendedSuggestion

권장 사항을 완료하기 위해 수행해야 하는 제안 사항입니다.

Name	형식	Description
action	string	제안의 동작입니다.
additionalProperties	object	제안에 대한 추가 속성의 컬렉션입니다.
description	string	제안에 대한 설명입니다.
suggestionTypeId	string	제안 형식의 ID입니다.
title	string	제안의 제목입니다.

State

권장 사항의 상태입니다.

Name	형식	Description
Active	string	권장 사항이 활성화되어 있습니다.
CompletedBySystem	string	권장 사항이 시스템에 의해 완료되었습니다.
CompletedByUser	string	권장 사항이 사용자에 의해 완료되었습니다.
Dismissed	string	권장 사항이 해제되었습니다.
InProgress	string	권장 사항이 진행 중입니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유