다음을 통해 공유


컴퓨터 작업 취소 API

적용 대상:

중요

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

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

아직 최종 상태가 아닌 이미 시작된 컴퓨터 작업을 취소합니다(완료, 취소, 실패).

제한 사항

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

권한

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

사용 권한 유형 사용 권한 사용 권한 표시 이름
응용 프로그램 Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantine
Machine.LiveResponse
포렌식 수집
컴퓨터 격리
코드 실행 제한
스캔 컴퓨터
컴퓨터 등록 취소
중지 및 격리
특정 컴퓨터에서 라이브 응답 실행
위임됨(회사 또는 학교 계정) Machine.CollectForensics
Machine.Isolate
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantineMachine.LiveResponse
포렌식 수집
컴퓨터 격리
코드 실행 제한
스캔 컴퓨터
컴퓨터 등록 취소
중지 및 격리
특정 컴퓨터에서 라이브 응답 실행

HTTP 요청

POST https://api.securitycenter.microsoft.com/api/machineactions/<machineactionid>/cancel

요청 헤더

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

요청 본문

매개 변수 형식 설명
Comment String 취소 작업과 연결할 주석입니다.

응답

성공하면 이 메서드는 Machine Action 엔터티가 있는 200 OK 응답 코드를 반환합니다. 지정된 ID를 가진 컴퓨터 작업 엔터티를 찾을 수 없는 경우 - 404 찾을 수 없습니다.

예제

요청

다음은 요청의 예입니다.

POST
https://api.securitycenter.microsoft.com/api/machineactions/988cc94e-7a8f-4b28-ab65-54970c5d5018/cancel
{
    "Comment": "Machine action was canceled by automation"
}

관련 문서

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