일반적인 REST API 오류 코드Common REST API error codes

  • 다음 표에 나열된 오류 코드는 끝점 API용 Microsoft Defender에 대한 작업으로 반환될 수 있습니다.The error codes listed in the following table may be returned by an operation on any of Microsoft Defender for Endpoint APIs.
  • 오류 코드 외에도 모든 오류 응답에는 문제 해결에 도움이 될 수 있는 오류 메시지가 포함되어 있습니다.In addition to the error code, every error response contains an error message, which can help resolve the problem.
  • 메시지는 변경할 수 있는 무료 텍스트입니다.The message is a free text that can be changed.
  • 페이지 아래쪽에서 응답 예제를 찾을 수 있습니다.At the bottom of the page, you can find response examples.

Endpoint용 Defender를 경험하고 싶나요?Want to experience Defender for Endpoint? 무료 평가판에 등록합니다.Sign up for a free trial.

오류 코드Error code HTTP 상태 코드HTTP status code 메시지Message
BadRequestBadRequest BadRequest (400)BadRequest (400) 일반 잘못된 요청 오류 메시지입니다.General Bad Request error message.
ODataErrorODataError BadRequest (400)BadRequest (400) OData URI 쿼리가 잘못되었습니다(특정 오류가 지정되었습니다).Invalid OData URI query (the specific error is specified).
InvalidInputInvalidInput BadRequest (400)BadRequest (400) 입력 {잘못된 입력}이(가) 잘못되었습니다.Invalid input {the invalid input}.
InvalidRequestBodyInvalidRequestBody BadRequest (400)BadRequest (400) 요청 본문이 잘못되었습니다.Invalid request body.
InvalidHashValueInvalidHashValue BadRequest (400)BadRequest (400) 해시 값 {the invalid hash}가 잘못되었습니다.Hash value {the invalid hash} is invalid.
InvalidDomainNameInvalidDomainName BadRequest (400)BadRequest (400) 도메인 이름 {잘못된 도메인}이(가) 잘못되었습니다.Domain name {the invalid domain} is invalid.
InvalidIpAddressInvalidIpAddress BadRequest (400)BadRequest (400) IP 주소 {잘못된 IP}가 잘못되었습니다.IP address {the invalid IP} is invalid.
InvalidUrlInvalidUrl BadRequest (400)BadRequest (400) URL {잘못된 URL}이(가) 잘못되었습니다.URL {the invalid URL} is invalid.
MaximumBatchSizeExceededMaximumBatchSizeExceeded BadRequest (400)BadRequest (400) 최대 일괄 처리 크기가 초과됩니다.Maximum batch size exceeded. Received: {batch size received}, allowed: {batch size allowed}.Received: {batch size received}, allowed: {batch size allowed}.
MissingRequiredParameterMissingRequiredParameter BadRequest (400)BadRequest (400) 매개 변수 {누락된 매개 변수}가 없습니다.Parameter {the missing parameter} is missing.
OsPlatformNotSupportedOsPlatformNotSupported BadRequest (400)BadRequest (400) OS 플랫폼 {클라이언트 OS 플랫폼}은 이 작업에서 지원되지 않습니다.OS Platform {the client OS Platform} is not supported for this action.
ClientVersionNotSupportedClientVersionNotSupported BadRequest (400)BadRequest (400) {요청된 작업}은 클라이언트 버전 {지원되는 클라이언트 버전} 이상에서 지원됩니다.{The requested action} is supported on client version {supported client version} and above.
권한이 없는 경우Unauthorized 권한이 없는 경우(401)Unauthorized (401) 권한이 부여되지 않았습니다(유효하지 않은 또는 만료된 권한 부여 헤더).Unauthorized (invalid or expired authorization header).
금지Forbidden 금지(403)Forbidden (403) 금지됩니다(유효한 토큰이지만 작업의 사용 권한이 부족).Forbidden (valid token but insufficient permission for the action).
DisabledFeatureDisabledFeature 금지(403)Forbidden (403) 테넌트 기능을 사용할 수 없습니다.Tenant feature is not enabled.
DisallowedOperationDisallowedOperation 금지(403)Forbidden (403) {the disallowed operation and the reason}.{the disallowed operation and the reason}.
NotFoundNotFound 찾을 수 없습니다(404)Not Found (404) 일반 찾을 수 없는 오류 메시지입니다.General Not Found error message.
ResourceNotFoundResourceNotFound 찾을 수 없습니다(404)Not Found (404) 리소스 {요청된 자원}을(를) 찾을 수 없습니다.Resource {the requested resource} was not found.
InternalServerErrorInternalServerError 내부 서버 오류(500)Internal Server Error (500) (오류 메시지 없음, 작업을 다시 시도)(No error message, retry the operation)
TooManyRequestsTooManyRequests 요청 수가 너무 많음(429)Too Many Requests (429) 응답은 요청 수 또는 CPU에 의해 할당량 제한에 도달하는 경우를 나타내게 됩니다.Response will represent reaching quota limit either by number of requests or by CPU.

본문 매개 변수는 대소문자 구분Body parameters are case-sensitive

제출된 본문 매개 변수는 현재 대소문자 구분됩니다.The submitted body parameters are currently case-sensitive.
InvalidRequestBody 또는 MissingRequiredParameter 오류가 발생하는 경우 매개 변수의 대/소문자 오류가 발생할 수 있습니다.If you experience an InvalidRequestBody or MissingRequiredParameter errors, it might be caused from a wrong parameter capital or lower-case letter.
API 설명서 페이지를 검토하고 제출된 매개 변수가 관련 예제와 일치하는지 확인하십시오.Review the API documentation page and check that the submitted parameters match the relevant example.

상관 관계 요청 IDCorrelation request ID

각 오류 응답에는 추적을 위한 고유 ID 매개 변수가 포함되어 있습니다.Each error response contains a unique ID parameter for tracking.
이 매개 변수의 속성 이름은 "target"입니다.The property name of this parameter is "target".
오류에 대해 문의할 때 이 ID를 첨부하면 문제의 근본 원인을 찾는 데 도움이 됩니다.When contacting us about an error, attaching this ID will help find the root cause of the problem.

예제Examples

{
    "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"
    }
}