일반적인 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 매개 변수가 포함됩니다. 이 매개 변수의 속성 이름은 대상입니다. 오류에 대해 Microsoft에 문의하는 경우 추적 ID를 첨부하면 Microsoft가 문제의 근본 원인을 찾는 데 도움이 됩니다.
- Microsoft Graph 보안 API 사용 - Microsoft Graph | Microsoft Learn
- Microsoft Defender XDR API 개요
- 지원되는 Microsoft Defender XDR API
- Microsoft Defender XDR API 액세스
- API 제한 및 라이선스에 대해 알아보기
팁
더 자세히 알아보고 싶으신가요? 기술 커뮤니티: Microsoft Defender XDR Tech Community의 Microsoft 보안 커뮤니티와 Engage.