다음을 통해 공유


도메인 관련 경고 API 가져오기

적용 대상:

엔드포인트용 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

API 설명

지정된 도메인 주소와 관련된 경고 컬렉션을 검색합니다.

제한 사항

  • 구성된 보존 기간에 따라 마지막으로 업데이트된 경고를 쿼리할 수 있습니다.
  • 이 API의 속도 제한은 분당 100개의 호출과 시간당 1,500건의 호출입니다.

권한

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

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

사용자 자격 증명을 사용하여 토큰을 가져올 때 사용자는 적어도 다음 역할 권한이 View Data 있어야 합니다( 역할 만들기 및 관리 참조).

응답에는 디바이스 그룹 설정에 따라 사용자가 액세스할 수 있는 디바이스와 연결된 경고만 포함됩니다( 디바이스 그룹 만들기 및 관리 참조).

디바이스 그룹 만들기는 엔드포인트용 Defender 플랜 1 및 플랜 2에서 지원됩니다.

HTTP 요청

GET /api/domains/{domain}/alerts

요청 헤더

헤더
권한 부여 String

요청 본문

비우다

응답

성공하고 도메인이 있는 경우 - 경고 엔터티 목록과 함께 200 OK입니다. 도메인이 없는 경우 - 빈 집합으로 200 OK

예제

요청

다음은 요청의 예입니다.

GET https://api.securitycenter.microsoft.com/api/domains/client.wns.windows.com/alerts

더 자세히 알아보고 싶으신가요? 기술 커뮤니티: 엔드포인트용 Microsoft Defender Tech Community의 Microsoft 보안 커뮤니티와 Engage.