Поделиться через

Коды ошибок REST API распространенных Microsoft Defender XDR

  • Статья

Область применения:

  • Microsoft Defender XDR

Примечание.

Попробуйте наши новые API с помощью API безопасности MS Graph. Дополнительные сведения см. в статье Использование API безопасности Microsoft Graph — Microsoft Graph | Microsoft Learn.

Важно!

Некоторые сведения относятся к предварительным выпускам продуктов, которые могут быть существенно изменены до коммерческого выпуска. Корпорация Майкрософт не дает никаких гарантий, явных или подразумеваемых, относительно предоставленных здесь сведений.

Коды ошибок могут быть возвращены операцией в любом из API-интерфейсов Microsoft Defender XDR. Каждый ответ об ошибке содержит сообщение об ошибке, которое может помочь устранить проблему. В столбце сообщения об ошибке в разделе таблицы содержатся примеры сообщений. Содержимое фактических сообщений зависит от факторов, которые вызвали ответ. Содержимое переменных указывается угловой скобкой (< >) в следующей таблице:

Коды ошибок

Код ошибки Код состояния HTTP Сообщение
BadRequest BadRequest (400) Общее сообщение об ошибке \"Неправильный запрос\" (Bad Request).
ODataError BadRequest (400) Недопустимый запрос <URI OData, где указана> конкретная ошибка.
InvalidInput BadRequest (400) Недопустимый ввод <недопустимых входных данных>.
InvalidRequestBody BadRequest (400) Недопустимый текст запроса.
InvalidHashValue BadRequest (400) Значение хэша <, недопустимое значение хэша> .
InvalidDomainName BadRequest (400) Доменное имя <недопустимого домена> .
InvalidIpAddress BadRequest (400) IP-адрес недопустимый IP-адрес<>.
InvalidUrl BadRequest (400) НЕДОПУСТИМЫй URL-адрес<>.
MaximumBatchSizeExceeded BadRequest (400) Превышен максимальный размер пакета. Получено: <получен> размер пакета, разрешено: {размер пакета разрешен}.
MissingRequiredParameter BadRequest (400) Параметр <отсутствует.>
OsPlatformNotSupported BadRequest (400) Платформа <ОС— клиентская платформа> ОС не поддерживается для этого действия.
ClientVersionNotSupported BadRequest (400) <Запрошенное действие> поддерживается в версии клиента, поддерживаемой версией <клиента, и более поздних версиях> .
Не авторизован (Unauthorized) Не авторизовано (401) Не авторизован (Unauthorized)

Эта ошибка обычно вызвана недопустимым или просроченным заголовком авторизации.
Запрещено Запрещено (403) Запрещено

Эта ошибка может возникнуть с допустимым маркером, но с недостаточным разрешением для действия.
DisabledFeature Запрещено (403) Функция клиента не включена.
DisallowedOperation Запрещено (403) <запрещенная операция и причина>.
NotFound Не найдено (404) Общее сообщение об ошибке \"Не найдено\".
ResourceNotFound Не найдено (404) Ресурс <, запрошенный ресурс> не найден.
InternalServerError Внутренняя ошибка сервера (500) Если сообщение об ошибке отсутствует, повторите операцию. Если проблема не устранена, обратитесь в корпорацию Майкрософт.

Примеры

{
    "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 и проверка, что отправленные параметры соответствуют соответствующему примеру.

Идентификатор отслеживания

Каждый ответ об ошибке содержит уникальный параметр идентификатора для отслеживания. Имя свойства этого параметра — target. Если вы обращаетесь в корпорацию Майкрософт по поводу ошибки, присоединение идентификатора отслеживания поможет корпорации Майкрософт найти первопричину проблемы.

Совет

Хотите узнать больше? Engage с сообществом Microsoft Security в нашем техническом сообществе: Microsoft Defender XDR Техническое сообщество.