다음을 통해 공유

라이브 응답 라이브러리에 파일 업로드

  • 아티클

적용 대상:

중요

이 게시물의 일부 정보는 상용으로 출시되기 전에 실질적으로 수정될 수 있는 사전 릴리스된 제품과 관련이 있습니다. 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

API 설명

라이브 응답 라이브러리에 파일을 업로드합니다.

제한 사항

  1. 파일 최대 크기 제한은 20MB입니다.

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

권한

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

사용 권한 유형 사용 권한 사용 권한 표시 이름
응용 프로그램 Library.Manage 라이브 응답 라이브러리 관리
위임됨(회사 또는 학교 계정) Library.Manage 라이브 응답 라이브러리 관리

HTTP 요청

업로드

POST https://api.security.microsoft.com/api/libraryfiles

요청 헤더

이름 유형 설명
권한 부여 String 전달자<토큰>입니다. 필수 특성입니다.
Content-Type 문자열 multipart/form-data. 필수 특성입니다.

요청 본문

요청 본문에서 양식 데이터 개체에 다음 매개 변수를 제공합니다.

매개 변수 형식 설명
File 파일 콘텐츠 라이브 응답 라이브러리에 업로드할 파일입니다. 필수
설명 String 파일에 대한 설명입니다.
ParametersDescription String (선택 사항) 스크립트를 실행하는 데 필요한 매개 변수입니다. 기본값은 빈 문자열입니다.
OverrideIfExists 부울 (선택 사항) 파일이 이미 있는 경우 파일을 재정의할지 여부입니다. 기본값은 빈 문자열입니다.

응답

  • 성공하면 이 메서드는 응답 본문에 200 - OK 응답 코드 및 업로드된 라이브 응답 라이브러리 엔터티를 반환합니다.

  • 성공하지 못한 경우: 이 메서드는 400 - 잘못된 요청을 반환합니다. 잘못된 요청은 일반적으로 잘못된 본문을 나타냅니다.

예제

요청

curl을 사용하는 요청의 예는 다음과 같습니다.

curl -X POST https://api.security.microsoft.com/api/libraryfiles -H
"Authorization: Bearer \$token" -F "file=\@mdatp1.png" -F
"ParametersDescription=test"
-F "HasParameters=true" -F "OverrideIfExists=true" -F "Description=test
description"

팁

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