8.4.1 Обзор
Для чтения всех полей существующего объекта данных необходимо выполнить следующий запрос:
GET <root URI>/<ContainerName>/<DataObjectName>
Для чтения одного или нескольких полей существующего объекта данных необходимо выполнить один из следующих запросов:
GET <root URI>/<ContainerName>/<DataObjectName>?<fieldname>;<fieldname>;...
GET <root URI>/<ContainerName>/<DataObjectName>?value:<range>;...
GET <root URI>/<ContainerName>/<DataObjectName>?metadata:<prefix>;...
где:
- <root URI> путь к облаку CDMI.
- <ContainerName> неотрицательное число промежуточных контейнеров.
- <DataObjectName> имя объекта данных, из которого необходимо произвести чтение.
- <fieldname> имя поля.
- <range> диапазон байтов значения объекта данных, которые необходимо вернуть в поле value.
- <prefix> шаблон префикса: возвращаются все метаданные, начинающиеся с данного префикса.
К объекту можно также обратиться как <root URI>/cdmi_objectid/<objectID>.
8.4.2 Опции
Следующие опции описывают поддерживаемые операции, которые можно выполнять при чтении существующего объекта данных:
- поддержка возможности чтения метаданных существующего объекта данных обозначена наличием опции cdmi_read_metadata у объекта;
- поддержка возможности чтения данных существующего объекта обозначена наличием опции cdmi_read_value у объекта;
- поддержка возможности чтения определенного диапазона байт значения объекта обозначена наличием опции cdmi_read_value_range у объекта.
8.4.3 Заголовки запроса
Заголовки HTTP запросов на чтение объекта данных CDMI, использующего тип содержимого CDMI, приведены в таблице 14.
Таблица 14 - Заголовки запроса - чтение объекта данных CDMI с использованием типа содержимого CDMI
Заголовок | Тип | Описание | Требование |
Accept | Header String | "application/cdmi-object" или допустимой значение, см. 5.13.2 | Опционально |
X-CDMI- SpecificationVersion | Header String | Список версий, поддерживаемых клиентом, разделенных запятыми, например, "1.0.2, 1.5, 2.0" | Обязательно |
8.4.4 Тело сообщения-запроса
Тело сообщения-запроса должно отсутствовать.