ГОСТ Р ИСО/МЭК 17826-2015
- <QueueName> Имя создаваемого объекта-очереди.
После создания, к объекту можно также обратиться как <root URI>/cdmi_objcctid/<objectlD>.
Новые объекты-очереди должны быть пустыми, за исключением случаев, когда они создаются
посредством копирования или перемещения существующей непустой очереди, либо в результате десе
риализации непустой сериализованной очереди.
11.2.2 Отсроченное завершение создания:
В ответ на запрос создания объекта-очереди, сервер может вернуть код 202 Accepted, что ука
зывает на то, что объект находится в процессе создания. Это полезно в случае длительных операций
(например, копировании объекта-очереди с большим количеством значений). Такой ответ означает, что:
- сервер должен вернуть заголовок Location, содержащий URI к создаваемому объекту вместо со
статусом HTTP 202 Accepted;
- статус 202 Accepted со стороны сервера удостоверяет, что были пройдены несколько проверок.
- пользователь авторизован для создания нового объекта-контейнера;
- пользователь авторизован для чтения любого исходного объекта, который необходимо пере
местить, скопировать, сериализовать или десериализовать;
- достаточно места для создания объекта-контейнера или, по крайней мере, достаточно места
для создания URI к сообщению об ошибке.
- клиент может не иметь опции немедленно обратиться к созданному объекту, например, из-за
задержек, вызванных использованием в реализации связности в конечном итоге.
Клиент выполняет операции GET к URI для отслеживания процесса создания. В ответ сервер
возвращает два поля в теле сообщения-ответа, которые описывают состояние выполнения опе
рации:
- обязательное текстовое поле completionStatus содержит «Processing». «Complete», либо строку
сообщения об ошибке, начинающуюся с «Error»;
- опциональное поле pcrcentComplete содержит процент выполнения принятого запроса PUT(от
0 до 100).
GET не возвращает объекты из очереди, если completionStatus не равно «Complete». Если созда
ние объекта завершается с ошибкой, создается URI, а поло completionStatus устанавливается равным
сообщению об ошибке. Удаление URI после обработки ошибки возлагается на клиента.
11.2.3 Опции
Следующие опции описывают поддерживаемые операции при создании нового объекта-очереди:
- поддержка возможности создания нового объекта-очереди обозначается наличием опции cdmi_
create_queue в родительском контейнере;
- если очередь, создаваемая в родительском контейнере, является ссылкой, поддержка этой
операции обозначается наличием опции cdmi_create_reference в родительском контейнере;
- если новая очередь является копией существующей, поддержка копирования обозначается на
личием опции cdmi_copy_queue в родительском контейнере;
- если новая очередь создается в результате перемещения существующей очереди, поддержка
этой операции обозначается наличием опции cdmi_move_queue в родительском контейнере;
- если новая очередь создается в результате операции десериализации, поддержка этой опера
ции обозначается наличием опции cdmi_deserialize_queue в родительском контейнере.
11.2.4 Заголовки запроса
Заголовки HTTP запросов на создание объекта-очереди CDMI с использованием типа содержи
мого CDMI приведены в таблице 81.
Т а б л и ц а 8 1 - Заголовки запроса - создание объекта-очереди с использованием типа содержимого CDMI
Тип
Заюлово*
Accept
Описание
’application.’cdmi-queue"
Требование
Обязательно
Content-Type
"application/cdmi-queue"
Обязательно
X-CDMI-
SpecificationVersion
Строка
заголовка
Строка
заголовка
Строка
заголовка
Слисок версий, поддерживаемых клиентом, разделенных
запятыми, например. ” 1.0.2. 1.5. 2.0”
Обязательно
83