소프트웨어 인벤토리 API 나열

  • 적용 대상: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1

API 설명

organization 소프트웨어 인벤토리를 검색합니다.

OData V4 쿼리를 지원합니다. OData 지원 연산자:

  • $filter 다음 속성에서 다음을 수행합니다.
    • id
    • name
    • vendor
  • $top 최대값은 10,000입니다.
  • $skip

엔드포인트용 Microsoft Defender 있는 OData 쿼리의 예제를 참조하세요.

권한

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

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

HTTP 요청

GET /api/Software

요청 헤더

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

요청 본문

빈

응답

성공하면 본문에 소프트웨어 인벤토리가 있는 200 OK를 반환합니다.

예제

요청 예제

다음은 요청의 예입니다.

GET https://api.security.microsoft.com/api/Software

응답 예제

다음은 응답의 예입니다.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
    "value": [
            {
                "id": "microsoft-_-edge",
                "name": "edge",
                "vendor": "microsoft",
                "weaknesses": 467,
                "publicExploit": true,
                "activeAlert": false,
                "exposedMachines": 172,
                "impactScore": 2.39947438
            }
            ...
        ]
}
  • Last updated on