조사 시작 API

적용 대상:

• 엔드포인트용 Microsoft Defender 플랜 2
• Microsoft 365 Defender

Endpoint용 Defender를 경험하고 싶나요? 무료 평가판을 신청하세요.

참고

미국 정부 고객인 경우 미국 정부 고객용 끝점용 Microsoft Defender에나열된 URIS를 사용하시기 바랍니다.

팁

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

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

API 설명

디바이스에서 자동화된 조사를 시작하세요.

자세한 내용은 자동화된 조사 개요를 참조하세요.

제한 사항

1. 이 API에 대한 속도 제한은 시간당 50개 호출입니다.

AIR에 대한 요구 사항

조직에 끝점용 Defender가 있어야 합니다(끝점용 Microsoft Defender에 대한 최소 요구 사항 참조).

현재 AIR은 다음 OS 버전만 지원됩니다.

• Windows Server 2019
• Windows Server 2022
• Windows 10 버전 1709(OS 빌드 16299.1085(KB4493441)이상
• Windows 10 버전 1803(OS 빌드 17134.704(KB4493464)이상
• Windows 10 버전 1803 이상
• Windows 11

사용 권한

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

사용 권한 유형	사용 권한	사용 권한 표시 이름
응용 프로그램	Alert.ReadWrite.All	'모든 경고 읽기 및 쓰기'
위임(직장 또는 학교 계정)	Alert.ReadWrite	'경고 읽기 및 쓰기'

참고

사용자 자격 증명을 사용하여 토큰을 얻을 때:

• 사용자에게 최소한 '활성 수정 작업' 역할 권한이 필요합니다(자세한 내용은 역할 만들기 및 관리 참조).
• 사용자는 장치 그룹 설정에 따라 장치에 액세스할 수 있습니다(자세한 내용은 장치 그룹 만들기 및 관리 참조).

HTTP 요청

POST https://api.security.microsoft.com/api/machines/{id}/startInvestigation

요청 헤더

이름	유형	설명
권한 부여	문자열	Bearer {token}. 필수입니다.
Content-Type	문자열	application/json. 필수입니다.

요청 본문

요청 본문에 다음 매개 변수를 사용하여 JSON 개체를 제공합니다.

매개 변수	유형	설명
Comment	String	작업과 연결되는 설명입니다. 필수입니다.

응답

성공하면 이 메서드는 응답 본문에 201 - 생성된 응답 코드 및 조사를 반환합니다.

예제

요청

다음은 요청의 예입니다.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/startInvestigation

{
  "Comment": "Test investigation"
}