컴퓨터 작업 취소 API

적용 대상:

중요

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

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

참고

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

팁

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

API 설명

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

이 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	법의학 수집 컴퓨터 격리 코드 실행 제한 컴퓨터 검사 컴퓨터 등록 취소 중지 및 격리 특정 컴퓨터에서 라이브 응답 실행

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

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

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

성공하면 이 메서드는 컴퓨터 작업 엔터티를 사용하여 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"
}