일반적인 Microsoft 365 Defender REST API 오류 코드

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

참고

Microsoft 365 Defender를 경험해 보고 싶으신가요? Microsoft 365 Defender 평가하고 파일럿하는 방법에 대해 자세히 알아보세요.

적용 대상:

  • Microsoft 365 Defender

중요

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

오류 코드는 모든 API에 대한 작업으로 Microsoft 365 Defender 있습니다. 모든 오류 응답에는 문제 해결에 도움이 될 수 있는 오류 메시지가 포함되어 있습니다. 표 섹션의 오류 메시지 열에는 몇 가지 예제 메시지가 표시됩니다. 실제 메시지의 내용은 응답을 트리거한 요인에 따라 달라집니다. 가변 콘텐츠는 표에 괄호로 표시됩니다.

오류 코드

오류 코드 HTTP 상태 코드 메시지
BadRequest BadRequest (400) 일반 잘못된 요청 오류 메시지입니다.
ODataError BadRequest (400) OData URI 쿼리가 <the specific error is specified> 잘못되었습니다.
InvalidInput BadRequest (400) 입력이 <the invalid input> 잘못되었습니다.
InvalidRequestBody BadRequest (400) 요청 본문이 잘못되었습니다.
InvalidHashValue BadRequest (400) 해시 값이 <the invalid hash> 잘못되었습니다.
InvalidDomainName BadRequest (400) 도메인 이름이 <the invalid domain> 잘못되었습니다.
InvalidIpAddress BadRequest (400) IP <the invalid IP> 주소가 잘못되었습니다.
InvalidUrl BadRequest (400) URL이 <the invalid URL> 잘못되었습니다.
MaximumBatchSizeExceeded BadRequest (400) 최대 일괄 처리 크기가 초과됩니다. Received: <batch size received> , allowed: {batch size allowed}.
MissingRequiredParameter BadRequest (400) 매개 <the missing parameter> 변수가 없습니다.
OsPlatformNotSupported BadRequest (400) 이 <the client OS Platform> 작업에서 OS 플랫폼이 지원되지 않습니다.
ClientVersionNotSupported BadRequest (400) <The requested action> 는 클라이언트 버전 <supported client version> 이상에서 지원됩니다.
권한이 없는 경우 권한이 없는 경우(401) 권한이 없는 경우

참고: 일반적으로 유효하지 않은 또는 만료된 권한 부여 헤더로 인해 발생했습니다.
금지 금지(403) 금지

참고: 유효한 토큰이지만 작업의 권한이 없습니다.
DisabledFeature 금지(403) 테넌트 기능을 사용할 수 없습니다.
DisallowedOperation 금지(403) <the disallowed operation and the reason>.
NotFound 찾을 수 없습니다(404) 일반 찾을 수 없는 오류 메시지입니다.
ResourceNotFound 찾을 수 없습니다(404) 리소스를 <the requested resource> 찾을 수 없습니다.
InternalServerError 내부 서버 오류(500) 참고: 오류 메시지가 없음, 작업을 다시 시도하거나 해결되지 않은 경우 Microsoft에 문의

예제

{
    "error": {
        "code": "ResourceNotFound",
        "message": "Machine 123123123 was not found",
        "target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
    }
}

{
    "error": {
        "code": "InvalidRequestBody",
        "message": "Request body is incorrect",
        "target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
    }
}

Body 매개 변수

중요

본문 매개 변수는 대소문자 구분입니다.

InvalidRequestBody 또는 MissingRequiredParameter 오류가 발생하는 경우 오타로 인해 발생할 수 있습니다. API 설명서를 검토하고 제출된 매개 변수가 관련 예제와 일치하는지 검토합니다.

추적 ID

각 오류 응답에는 추적을 위한 고유 ID 매개 변수가 포함되어 있습니다. 이 매개 변수의 속성 이름은 대상입니다. 오류에 대해 문의할 때 이 ID를 첨부하면 문제의 근본 원인을 찾는 데 도움이 됩니다.