Коды ошибок 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. Если вы обращаетесь в корпорацию Майкрософт по поводу ошибки, присоединение идентификатора отслеживания поможет корпорации Майкрософт найти первопричину проблемы.
- Использование API безопасности Microsoft Graph — Microsoft Graph | Microsoft Learn
- Общие сведения об API Microsoft Defender XDR
- Поддерживаемые API Microsoft Defender XDR
- Доступ к API Microsoft Defender XDR
- Сведения об ограничениях API и лицензировании
Совет
Хотите узнать больше? Engage с сообществом Microsoft Security в нашем техническом сообществе: Microsoft Defender XDR Техническое сообщество.