모든 권장 사항 목록

아티클
08/14/2024

적용 대상:

엔드포인트용 Microsoft Defender를 경험하고 싶으신가요? 무료 평가판을 신청하세요.

참고

미국 정부 고객인 경우 미국 정부 고객용 엔드포인트용 Microsoft Defender에 나열된 URI를 사용하세요.

팁

성능을 향상시키려면 서버를 지리적 위치에 더 가깝게 사용할 수 있습니다.

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

중요

이 게시물의 일부 정보는 상용으로 출시되기 전에 실질적으로 수정될 수 있는 사전 릴리스된 제품과 관련이 있습니다. Microsoft는 여기에서 제공되는 정보와 관련하여 명시적이거나 묵시적인 어떠한 보증도 하지 않습니다.

조직에 영향을 주는 모든 보안 권장 사항 목록을 검색합니다.

API 설명

조직에 영향을 주는 모든 보안 권장 사항에 대한 정보를 반환합니다.

URL: GET:/api/recommendations
OData V4 쿼리를 지원합니다.
OData 지원 연산자:
$filteron: id, , productName, recommendedVersionvendor, recommendationCategory, subCategory, severityScore, remediationType, , recommendedProgram, 및 statusrecommendedVendor속성.
$top 최대값은 10,000입니다.
$skip.
엔드포인트용 Microsoft Defender를 사용하는 OData 쿼리의 예제를 참조하세요.

권한

이 API를 호출하려면 다음 권한 중 하나가 필요합니다. 사용 권한을 선택하는 방법을 포함하여 자세한 내용은 엔드포인트용 Microsoft Defender API 사용을 참조하세요.

사용 권한 유형	사용 권한	사용 권한 표시 이름
응용 프로그램	SecurityRecommendation.Read.All	'위협 및 취약성 관리 보안 권장 사항 정보 읽기'
위임됨(회사 또는 학교 계정)	SecurityRecommendation.Read	'위협 및 취약성 관리 보안 권장 사항 정보 읽기'

HTTP 요청

GET /api/recommendations

요청 헤더

이름	유형	설명
권한 부여	String	전달자 {token}. 필수입니다.

요청 본문

비우다

응답

성공하면 이 메서드는 본문의 보안 권장 사항 목록과 함께 200 OK를 반환합니다.

예제

요청

다음은 요청의 예입니다.

GET https://api.securitycenter.microsoft.com/api/recommendations

응답

다음은 응답의 예입니다.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations",
    "value": [
        {
            "id": "va-_-microsoft-_-edge_chromium-based",
            "productName": "edge_chromium-based",
            "recommendationName": "Update Microsoft Edge Chromium-based to version 127.0.2651.74",
            "weaknesses": 762,
            "vendor": "microsoft",
            "recommendedVersion": "127.0.2651.74",
            "recommendedVendor": "",
            "recommendedProgram": "",
            "recommendationCategory": "Application",
            "subCategory": "",
            "severityScore": 0,
            "publicExploit": true,
            "activeAlert": false,
            "associatedThreats": [
                "71d9120e-7eea-4058-889a-1a60bbf7e312"
            ],
            "remediationType": "Update",
            "status": "Active",
            "configScoreImpact": 0,
            "exposureImpact": 1.1744086343876479,
            "totalMachineCount": 261,
            "exposedMachinesCount": 193,
            "nonProductivityImpactedAssets": 0,
            "relatedComponent": "Edge Chromium-based",
            "hasUnpatchableCve": false,
            "tags": [
            "internetFacing"
            ],
            "exposedCriticalDevices": 116
        }
     ]
}

참고 항목

팁

더 자세히 알아보고 싶으신가요? Microsoft 기술 커뮤니티: 엔드포인트용 Microsoft Defender 기술 커뮤니티에서 Microsoft 보안 커뮤니티에 참여하세요.

다음을 통해 공유