Recommendations - Get

참조

서비스:: Advisor

API 버전:: 2023-01-01

캐시된 권장 사항의 세부 정보를 가져옵니다.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.Advisor/recommendations/{recommendationId}?api-version=2023-01-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
recommendationId	path	True	string	권장 사항 ID입니다.
resourceUri	path	True	string	권장 사항이 적용되는 리소스의 정규화된 Azure Resource Manager 식별자입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다.

응답

Name	형식	Description
200 OK	ResourceRecommendationBase	OK. 권장 사항 세부 정보를 가져왔습니다.
Other Status Codes	ArmErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

GetRecommendationDetail

샘플 요청

HTTP

GET https://management.azure.com/resourceUri/providers/Microsoft.Advisor/recommendations/recommendationId?api-version=2023-01-01

샘플 응답

상태 코드:: 200

{
  "id": "/resourceUri/providers/Microsoft.Advisor/recommendations/recommendationId",
  "name": "recommendationId",
  "properties": {
    "category": "Security",
    "impact": "Medium",
    "impactedField": "Microsoft.Compute/virtualMachines",
    "impactedValue": "armavset",
    "lastUpdated": "2017-02-24T22:24:43.3216408Z",
    "risk": "Warning",
    "shortDescription": {
      "problem": "Monitoring agent should be installed on your machines",
      "solution": "Monitoring agent should be installed on your machines"
    },
    "remediation": {
      "additionalProperties": {
        "httpMethod": "POST",
        "uri": "uri",
        "details": "link to document"
      }
    },
    "resourceMetadata": {
      "resourceId": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Compute/virtualMachines/xyz",
      "source": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Compute/virtualMachines/xyz/providers/Microsoft.Security/assessments/assessmentGuid",
      "action": {
        "additionalProperties": {
          "actionType": "Document",
          "link": "https://link3",
          "caption": "Enable Soft Delete to protect blob data",
          "description": "Enable Soft Delete to protect blob data"
        },
        "metadata": {
          "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Compute/virtualMachines/xyz"
        }
      },
      "singular": "Virtual machine",
      "plural": "Virtual machines"
    },
    "actions": [
      {
        "additionalProperties": {
          "actionType": "Document",
          "link": "https://link1",
          "caption": "Enable Soft Delete to protect blob data",
          "description": "Enable Soft Delete to protect blob data"
        },
        "metadata": {
          "id": "/subscriptions/subscriptionId"
        }
      }
    ],
    "description": "After enabling Soft Delete, deleted data transitions to a soft deleted state instead of being permanently deleted. When data is overwritten, a soft deleted snapshot is generated to save the state of the overwritten data. You can configure the amount of time soft deleted data is recoverable before it permanently expires.",
    "label": "Enable Soft Delete",
    "learnMoreLink": "https://link2",
    "potentialBenefits": "Save and recover your data when blobs or blob snapshots are accidentally overwritten or deleted"
  },
  "type": "Microsoft.Advisor/recommendations"
}

정의

Name	Description
ArmErrorResponse
ARMErrorResponseBody	ARM 오류 응답 본문입니다.
category	권장 사항의 범주입니다.
createdByType	리소스를 만든 ID의 형식입니다.
impact	권장 사항의 비즈니스 영향.
ResourceMetadata	권장 리소스 메타데이터
ResourceRecommendationBase	Advisor 권장 사항.
risk	권장 사항을 구현하지 못할 위험이 있습니다.
ShortDescription	권장 사항의 요약입니다.
systemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

ArmErrorResponse

Name	형식	Description
error	ARMErrorResponseBody	ARM 오류 응답 본문입니다.

ARMErrorResponseBody

ARM 오류 응답 본문입니다.

Name	형식	Description
code	string	오류를 프로그래밍 방식으로 식별하는 데 사용할 수 있는 문자열을 가져오거나 설정합니다.
message	string	오류를 자세히 설명하고 디버깅 정보를 제공하는 문자열을 가져오거나 설정합니다.

Name	형식	Description
Cost	string
HighAvailability	string
OperationalExcellence	string
Performance	string
Security	string

createdByType

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

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

impact

권장 사항의 비즈니스 영향.

Name	형식	Description
High	string
Low	string
Medium	string

ResourceMetadata

권장 리소스 메타데이터

Name	형식	Description
action	object	리소스를 보는 작업입니다.
plural	string	리소스 유형의 복수 사용자 식별 이름입니다. 예: 가상 머신
resourceId	string	평가된 리소스의 Azure 리소스 ID
singular	string	리소스 유형의 단일 사용자 식별 이름입니다. 예: 가상 머신
source	string	권장 사항이 생성되는 원본

ResourceRecommendationBase

Advisor 권장 사항.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름입니다.
properties.actions	object[]	권장 사항을 구현하는 권장 작업 목록입니다.
properties.category	category	권장 사항의 범주입니다.
properties.description	string	권장 사항에 대한 자세한 설명입니다.
properties.exposedMetadataProperties	object	추가 정보를 제공하기 위해 고객에게 노출되는 권장 사항 메타데이터 속성입니다.
properties.extendedProperties	object	확장 속성
properties.impact	impact	권장 사항의 비즈니스 영향.
properties.impactedField	string	Advisor에서 식별한 리소스 종류입니다.
properties.impactedValue	string	Advisor에서 식별한 리소스입니다.
properties.label	string	권장 사항의 레이블입니다.
properties.lastUpdated	string	Advisor가 권장 사항의 유효성을 확인한 가장 최근 시간입니다.
properties.learnMoreLink	string	권장 사항 및 생성 논리에 대해 자세히 알아볼 수 있는 링크입니다.
properties.metadata	object	권장 사항 메타데이터입니다.
properties.potentialBenefits	string	권장 사항을 구현할 때의 잠재적 이점입니다.
properties.recommendationTypeId	string	권장 사항 유형 GUID입니다.
properties.remediation	object	권장 사항을 적용하는 자동화된 방법입니다.
properties.resourceMetadata	ResourceMetadata	평가된 리소스의 메타데이터
properties.risk	risk	권장 사항을 구현하지 못할 위험이 있습니다.
properties.shortDescription	ShortDescription	권장 사항의 요약입니다.
properties.suppressionIds	string[]	권장 사항에 대한 다시 알림 및 해제된 규칙 목록입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

risk

권장 사항을 구현하지 못할 위험이 있습니다.

Name	형식	Description
Error	string
None	string
Warning	string

ShortDescription

권장 사항의 요약입니다.

Name	형식	Description
problem	string	권장 사항 및 제안된 솔루션으로 식별된 문제 또는 기회입니다.
solution	string	권장 사항 및 제안된 솔루션으로 식별된 문제 또는 기회입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

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

다음을 통해 공유