라이브 응답 결과 얻기

  • 아티클
  • 읽는 데 2분 걸림

적용 대상:

중요

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

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

참고

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

팁

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

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

API 설명

인덱스로 특정 라이브 응답 명령 결과를 검색합니다.

제한 사항

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

최소 요구 사항

장치에서 세션을 시작하려면 먼저 다음 요구 사항을 충족해야 합니다.

사용 권한

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

사용 권한 유형 사용 권한 사용 권한 표시 이름
응용 프로그램 Machine.Read.All ''모든 컴퓨터 프로필 읽기''
응용 프로그램 "Machine.ReadWrite.All '모든 컴퓨터 정보 읽기 및 쓰기'
위임(직장 또는 학교 계정) Machine.LiveResponse 특정 컴퓨터의 실시간 응답 실행

HTTP 요청

GET https://api.securitycenter.microsoft.com/api/machineactions/{machine action
id}/GetLiveResponseResultDownloadLink(index={command-index})

요청 헤더

이름 유형 설명
권한 부여 String Bearer {token}. 필수 특성입니다.

요청 본문

비어 있음

응답

성공하면 이 메서드는 명령 결과에 대한 링크를 보유하는 개체가 있는 200, 확인 응답 코드를 반환합니다. 이 링크는 30분 동안 유효하며 로컬 저장소에 패키지를 다운로드하는 데 즉시 사용해야 합니다. 만료된 링크를 다른 호출로 다시 만들 수 있으며 라이브 응답을 다시 실행할 필요가 없습니다.

런스크립트 전사 속성:

속성 설명
script_name 실행된 스크립트 이름
exit_code 실행된 스크립트 종료 코드
script_output 실행된 스크립트 표준 출력
script_errors 실행된 스크립트 표준 오류 출력

예제

요청 예제

다음은 요청의 예입니다.

GET https://api.securitycenter.microsoft.com/api/machineactions/988cc94e-7a8f-4b28-ab65-54970c5d5018/GetLiveResponseResultDownloadLink(index=0)

응답 예제

다음은 응답의 예입니다.

HTTP/1.1 200 Ok

콘텐츠 형식: application/json

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Edm.String",
    "value": "https://core.windows.net/investigation-actions-data/ID/CustomPlaybookCommandOutput/4ed5e7807ad1fe59b00b664fe06a0f07?se=2021-02-04T16%3A13%3A50Z&sp=r&sv=2019-07-07&sr=b&sig=1dYGe9rPvUlXBPvYSmr6/OLXPY98m8qWqfIQCBbyZTY%3D"
}

파일 콘텐츠:

{
    "script_name": "minidump.ps1",
    "exit_code": 0,
    "script_output": "Transcript started, output file is C:\\ProgramData\\Microsoft\\Windows Defender Advanced Threat Protection\\Temp\\PSScriptOutputs\\PSScript_Transcript_{TRANSCRIPT_ID}.txt
C:\\windows\\TEMP\\OfficeClickToRun.dmp.zip\n51 MB\n\u0000\u0000\u0000",
    "script_errors":""
}