ГОСТ Р ИСО/МЭК 17826-2015
10.3 Чтение объекта-домена с использованием типа содержимого CDMI
10.3.1 Обзор
Для чтения всех полей существующего объекта-домена следует выполнить запрос:
GET <root URI>/cdmi_domains/<DomainName>;<TheDomainName>/
Для чтения одного или нескольких выбранных полей из существующего объекта-домена следует
выполнить один из следущих запросов:
- GET <root URI>/cdmi_domains/<DomainName>/<TheDomainName>/?<fieldname>:<fieldname>;...
- GET <root URI>/cdmi_domains/<DomainName>/<TheDomainName>/?children:<range>;...
- GET <root URI>/cdmi_domains/<DomainName>/<TheDomainName>/?metadata:<prefix>;...
где:
- <root URI> путь к облаку CDMI;
- <DomainName> неотрицательное число родительских доменов;
- <TheDomainName> имя домена, из которого необходимо провести чтение:
- <fieldname> имя поля;
- <range> числовой диапазон в списке потомков:
- <prefix> соответствующий префикс, возвращающий все метаданные, начинащиеся с данного
префикса..
К объекту можно также обратиться как <root URI>/cdmi_objectid/<objectlD>/.
10.3.2 Опции
Следующие опции описывают поддерживаемые операции при чтении существующего домена:
- поддержка возможности чтения метаданных существующего объекта-домена обозначается на
личием опции cdmi_read_metadata в домене.
- поддержка возможности перечисления потомков существующего объекта-домена обозначается
наличием опции cdmi_list_children в домене.
10.3.3 Заголовки запроса
Заголовки HTTP запроса на чтение из объекта-домена CDMI с использованием типа содержимого
CDMI приведены в таблице 71.
Т а б л и ц а 7 1 - Заголовки запроса - чтение из объекта-домена с использованием типа содержимого CDMI
ЗаголовокТипОписаниеТребование
AcceptСтрока
заголовка
гласно 5.13.2
"applicatiofVcdmi-container" или совместимое значение со Опционально
X-CDMI-
SpecificationVersion
Строка
заголовка
запятыми, например. "1.0.2. 1.5, 2.0’
Слисок версий, поддерживаемых клиентом, разделенных Обязательно
10.3.4 Тело сообщения-запроса
Тело сообщения должно отсутствовать в запросе.
10.3.5 Заголовки ответа
Заголовки HTTP ответа для чтения объекта-домена CDMI с использованием типа содержимого
CDMI приведены в таблице 72.
Т а б л и ц а 7 2 - Заголовки ответа - чтение из объекта-домена с использованием типа содержимого CDMI
Заголовок
Тип
Описание
Требование
X-CDMI-
SpecificationVe rsion
Строка
заголовка
Сервер должен вернуть наибольший номер версии, поддер
живаемой и сервером, и клиенток», например, "1.0.2".
Если сервер не поддерживает ни одной версии, поддержи
Обязательно
Content-TypeСтрока
заголовка
ваемой клиентом, сервер должен вернуть код состояния 400 Bad
Request.
"application/cdmi-domain’Обязательно
LocationСтрока
заголовка
адресация, если объект является ссылкой.
Сервер должен вернуть URI, на который происходит переУсловно
76