다음을 통해 공유

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

  • 아티클

적용 대상:

  • Microsoft Defender XDR

참고

MS Graph 보안 API를 사용하여 새 API를 사용해 보세요. 자세한 정보: Microsoft Graph 보안 API 사용 - Microsoft Graph | Microsoft Learn.

중요

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

오류 코드는 Microsoft Defender XDR API의 작업에서 반환할 수 있습니다. 모든 오류 응답에는 문제를 resolve 데 도움이 될 수 있는 오류 메시지가 포함되어 있습니다. 테이블 섹션의 오류 메시지 열은 몇 가지 샘플 메시지를 제공합니다. 실제 메시지의 내용은 응답을 트리거한 요인에 따라 달라집니다. 변수 콘텐츠는 다음 표의 꺾쇠괄호(< >)로 표시됩니다.

오류 코드

오류 코드 HTTP 상태 코드 메시지
BadRequest BadRequest (400) 일반 잘못된 요청 오류 메시지입니다.
ODataError BadRequest (400) 잘못된 OData URI 쿼리 <에 특정 오류가 지정되었습니다>.
InvalidInput BadRequest (400) 잘못된 입력 <이 잘못되었습니다>.
InvalidRequestBody BadRequest (400) 잘못된 요청 본문입니다.
InvalidHashValue BadRequest (400) 잘못된 해시> 값<이 잘못되었습니다.
InvalidDomainName BadRequest (400) 잘못된 도메인이 잘못된 도메인> 이름<입니다.
InvalidIpAddress BadRequest (400) IP 주소 <가 잘못되었습니다> .
InvalidUrl BadRequest (400) URL <잘못된 URL> 이 잘못되었습니다.
MaximumBatchSizeExceeded BadRequest (400) 최대 일괄 처리 크기를 초과했습니다. 수신됨: <받은> 일괄 처리 크기, 허용됨: {batch size allowed}.
MissingRequiredParameter BadRequest (400) 매개 변수 <누락된 매개 변수> 가 없습니다.
OsPlatformNotSupported BadRequest (400) OS 플랫폼 <클라이언트 OS 플랫폼> 은 이 작업에 대해 지원되지 않습니다.
ClientVersionNotSupported BadRequest (400) <요청된 작업은> 클라이언트 버전 지원 클라이언트 버전 <> 이상에서 지원됩니다.
무단 권한 없음(401) 무단

이 오류는 일반적으로 유효하지 않거나 만료된 권한 부여 헤더로 인해 발생합니다.
사용 권한 없음 사용할 수 없음(403) 사용 권한 없음

이 오류는 유효한 토큰이지만 작업에 대한 권한이 부족하여 발생할 수 있습니다.
DisabledFeature 사용할 수 없음(403) 테넌트 기능을 사용할 수 없습니다.
DisallowedOperation 사용할 수 없음(403) <허용되지 않는 작업 및 이유>입니다.
NotFound 찾을 수 없음(404) 일반 찾을 수 없음 오류 메시지입니다.
ResourceNotFound 찾을 수 없음(404) <요청된 리소스>를 찾을 수 없습니다.
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"
    }
}

본문 매개 변수

중요

본문 매개 변수는 대/소문자를 구분합니다.

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

추적 ID

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

팁

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