Префикс статуса ключевого слова (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
