IPP 1.1 | Классы ответов операций

Префикс статуса ключевого слова (prefix of the status keyword) определяет класс ответа IPP 1.1 следующим образом: (смотри Приложение B из RFC 8011)

Префикс статуса ключевого слова Значение Описание Диапазон ОТ Диапазон ДО Определено в RFC 8011
informational информационный запрос получен, продолжение процесса 0x0100 0x01ff Раздел B.1.1
successful успешный действие было успешно принято, понято и одобрено 0x0000 0x00ff Раздел B.1.2
redirection перенаправление для выполнения запроса предпринимаются дальнейшие действия 0x0300 0x03ff Раздел B.1.3
client-error ошибка клиента запрос содержит неверный синтаксис или не может быть выполнен 0x0400 0x04ff Раздел B.1.4
server-error ошибка сервера объекту IPP не удалось выполнить явно допустимый запрос 0x0500 0x05ff Раздел B.1.5

Таблица префиксов статусов ответов ключевого слова в IPP 1.1

В этом разделе определяются ключевые слова перечисляемых кодов состояний (status-code enum keywords) и значения, которые используются для предоставления семантической информации о результатах запроса операции. Каждый ответ операции ДОЛЖЕН включать код состояния (status-code). Ответ МОЖЕТ также содержать сообщение о состоянии (status message), которое содержит краткое текстовое описание состояния (description of the status). Код состояния предназначен для использования автоматами, а сообщение о статусе предназначено для конечного пользователя.

Как и в случае перечислений «type2«, значения кода состояния IPP являются расширяемыми. Независимо от того, распознаны ли все значения кода состояния, Клиенты IPP ДОЛЖНЫ понимать класс любого кода состояния, как указано в префиксе, и рассматривать любой нераспознанный ответ как эквивалент первого кода состояния этого класса, за исключением что нераспознанный ответ НЕ ДОЛЖЕН кэшироваться. Например, если клиент получил нераспознанный код состояния «client-error-xxx-yyy», он может с уверенностью предположить, что с его запросом что-то не так, и обработать ответ так, как если бы он получил статус кода «client-error-bad-request». Имя «enum» (перечисления) — это рекомендуемое сообщение о статусе для английского языка США.

См. [PWG5100.19] для рекомендаций по представлению сообщений о состоянии конечным пользователям.

Значения кода состояния ответа находятся в диапазоне от 0x0000 до 0x7fff.

Верхняя половина (128 значений) каждого диапазона (от 0x0n80 до 0x0nff, для n = 0 до 5) зарезервирована для использования поставщиком в каждом классе кода состояния. Значения от 0x0600 до 0x7fff зарезервированы для последующего присвоения документами стандартов «Standards Track» и НЕ ДОЛЖНЫ использоваться.

Ссылки на документы

Читать полную версию документа на русском языке RFC 8011 | Протокол интернет-печати (IPP)/1.1: модель и семантика

Скачать оригинальный документ на английском языке RFC 8011 PDF — Internet Printing Protocol/1.1: Model and Semantics

Поделись записью