ID별 권장 사항 가져오기Get recommendation by ID

적용 사항: 끝점용 Microsoft DefenderApplies to: Microsoft Defender for Endpoint

참고

미국 정부 고객인 경우 미국 정부 고객용 끝점용 Microsoft Defender에나열된 URIS를 사용하시기 바랍니다.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

성능을 향상하기 위해 지리적 위치에 더 가까운 서버를 사용할 수 있습니다.For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

중요

일부 정보는 상용으로 출시되기 전에 실질적으로 수정될 수 있는 사전 릴리스된 제품과 관련이 있습니다.Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft는 여기에서 제공하는 정보와 관련하여 명시적이거나 묵시적인 어떠한 보증도 제공하지 않습니다.Microsoft makes no warranties, express or implied, with respect to the information provided here.

ID로 보안 권장을 검색합니다.Retrieves a security recommendation by its ID.

사용 권한Permissions

이 API를 호출하려면 다음 권한 중 하나가 필요합니다.One of the following permissions is required to call this API. 사용 권한을 선택하는 방법을 포함하여 자세한 내용은 Use Microsoft Defender for Endpoint API for details을 참조합니다.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

사용 권한 유형Permission type 사용 권한Permission 사용 권한 표시 이름Permission display name
응용 프로그램Application SecurityRecommendation.Read.AllSecurityRecommendation.Read.All '위협 및 취약성 관리 보안 권장 정보 읽기''Read Threat and Vulnerability Management security recommendation information'
위임(직장 또는 학교 계정)Delegated (work or school account) SecurityRecommendation.ReadSecurityRecommendation.Read '위협 및 취약성 관리 보안 권장 정보 읽기''Read Threat and Vulnerability Management security recommendation information'

HTTP 요청HTTP request

GET /api/recommendations/{id}

요청 헤더Request headers

이름Name 유형Type 설명Description
권한 부여Authorization StringString Bearer {token}.Bearer {token}. 필수입니다.Required.

요청 본문Request body

비어 있음Empty

응답Response

성공하면 이 메서드는 본문의 보안 권장 사항을 사용하여 200 OK를 반환합니다.If successful, this method returns 200 OK with the security recommendations in the body.

예시Example

요청Request

다음은 요청의 예입니다.Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome

응답Response

다음은 응답의 예입니다.Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations/$entity",
    "id": "va-_-google-_-chrome",
    "productName": "chrome",
    "recommendationName": "Update Chrome",
    "weaknesses": 38,
    "vendor": "google",
    "recommendedVersion": "",
    "recommendationCategory": "Application",
    "subCategory": "",
    "severityScore": 0,
    "publicExploit": false,
    "activeAlert": false,
    "associatedThreats": [],
    "remediationType": "Update",
    "status": "Active",
    "configScoreImpact": 0,
    "exposureImpact": 3.9441860465116285,
    "totalMachineCount": 6,
    "exposedMachinesCount": 5,
    "nonProductivityImpactedAssets": 0,
    "relatedComponent": "Chrome"
}