Национальный стандарт республики казахстан



страница9/33
Дата20.11.2016
Размер4.62 Mb.
Просмотров6922
Скачиваний0
1   ...   5   6   7   8   9   10   11   12   ...   33

8.4.8 Примеры
ПРИМЕР 1 ПОЛУЧИТЬ объект данных URI для чтения всех полей объекта данных:
GET /MyContainer/MyDataObject.txt HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2


Ниже приведен ответ.
HTTP/1.1 200 OK

X-CDMI-Specification-Version: 1.0.2

Content-Type: application/cdmi-object

{


"objectType" : "application/cdmi-object",

"objectID" : "0000706D0010B84FAD185C425D8B537E",

"objectName" : "MyDataObject.txt",

"parentURI" : "/MyContainer/",

"parentID" : "00007E7F00102E230ED82694DAA975D2",

"domainURI" : "/cdmi_domains/MyDomain/",

"capabilitiesURI" : "/cdmi_capabilities/dataobject/",

"completionStatus" : "Complete",

"mimetype" : "text/plain",

"metadata" : {

"cdmi_size" : "37"

},


"valuerange" : "0-36",

"valuetransferencoding" : "utf-8",

"value" : "This is the Value of this Data Object"

}
ПРИМЕР 2 ПОЛУЧИТЬ URI по Идентификатору объекта данных для чтения всех полей объекта данных:


GET /cdmi_objectid/0000706D0010B84FAD185C425D8B537E

HTTP/1.1 Host: cloud.example.com

Accept: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2


Ниже приведен ответ.

HTTP/1.1 200 OK

Content-Type: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2

{

"objectType" : "application/cdmi-object",



"objectID" : "0000706D0010B84FAD185C425D8B537E",

"objectName" : "MyDataObject.txt",

"parentURI" : "/MyContainer/",

"parentID" : "00007E7F00102E230ED82694DAA975D2",

"domainURI" : "/cdmi_domains/MyDomain/",

"capabilitiesURI" : "/cdmi_capabilities/dataobject/",

"completionStatus" : "Complete",

"mimetype" : "text/plain",

"metadata" : {

"cdmi_size" : "37"

},

"valuetransferencoding" : "utf-8",



"valuerange" : "0-36",

"value" : "This is the Value of this Data Object"



Это значение этого объекта данных"
ПРИМЕР 3 ПОЛУЧИТЬ объект данных URI для чтения поля

значения и тип -МПИР объекта данных:
GET /MyContainer/MyDataObject.txt?value;mimetype HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2



Ниже приведен ответ.

HTTP/1.1 200 OK

Content-Type: application/cdmi-obj ect

X-CDMI-Specification-Version: 1.0.2

{

"value" : "This is the Value of this Data Object", "mimetype" : "text/plain"
ПРИМЕР 4 ДОБРАТЬСЯ до объекта данных URI, чтобы прочитать

первые 11 байтов значения объекта данных:

GET /MyContainer/MyDataObject.txt?valuerange;value:0-10 HTTP/1.1 Host: cloud.example.com Accept: application/cdmi-object X-CDMI-Specification-Version: 1.0.2

Ниже приведен ответ.

HTTP/1.1 200 OK

Content-Type: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2

{

"valuerange" : "0-10",

"value" : "VGhpcyBpcyB0aGU="

}
8.5 Чтение данных объекта с помощью типа контента CDMI
8.5.1 Краткий обзор
Для чтения значения из существующего объекта данных, должен выполняться следующий запрос:

GET //

Где:

  • это путь к CDMI облако.

  • это ноль или более промежуточных контейнеров.

  • это имя объекта считываемых данных.

Объект также должен быть доступен в /cdmi_objectid/.
8.5.2 Возможности
Следующие возможности описания поддерживаемых операций, которые могут быть выполнены при чтении существующего объекта данных:

Поддержка умения читать значение существующего объекта данных указывает наличие способности cdmi_read_value в указанном объекте. Любое чтение из указанного места байт не написанный ранее по созданию или обновлению операции должен возвращать нуль для значения байтов.

Поддержка умения читать значение существующего объекта данных в определенных диапазонах байт указывается наличием способности cdmi_read_value_range в указанном объекте. Любое чтение из указанного места байт не написанный ранее, по созданию или обновлению операции должен возвращать нуль для значения байтов.

8.5.3 Заголовок запроса
Заголовок запроса HTTP для чтения объекта данных CDMI с использованием типа содержимого не-CDMI показано в таблице 18.
Таблица 18 - Заголовок запроса- Чтение объекта данных CDMI используя тип содержимого не-CDMI

Заголовок

Тип

Описание

Требование

Диапазон

Заголовок строки

Действительный диапазон спецификатор (см. RFC 2616 раздел 14.35.1)

Необязательное


8.5.4 Текст сообщения запроса
Текст сообщения запроса не должны быть предусмотрены.
8.5.5 Заголовки ответов
Заголовки HTTP ответа для чтения объектов данных, используя тип содержимого не-CDMI приведены в таблице 19.
Таблица 19 - Заголовки ответов - Прочитать объект данных CDMI используя тип содержимого не-CDMI

Заголовок

Тип

Описание

Требование

Тип содержимого

Заголовок строки

Тип содержимого должен быть в поле тип-МПИР в объекте данных.

Обязательное

Расположение

Заголовок строки

Сервер должен отвечать URI, что ссылка перенаправляется к объекту, если объект является ссылкой.

Условное


8.5.6 Текст сообщения ответа
При чтении данных с помощью объекта типа содержимого не-CDMI, применяется следующее:

Текст сообщения ответа должен быть содержимое поля значения объекта данных.

При чтении значения, нуль должен быть возвращен для любых пробелов, обусловленные несмежными записями.
8.5.7 Статус ответа
Текст ответное сообщение должно быть содержание поля значения объекта данных.

При чтении значения, нули должны быть возвращены для каких-либо пробелов в результате несмежных записей.

Коды состояния HTTP, которые происходят при чтении данных с помощью объекта типа содержимого не-CDMI описаны в таблице 20.
Таблица 20 - Коды состояния HTTP - Чтение объекта данных CDMIс помощью содержимого типа не-CDMI

Статус HTTP

Описание

200 ХОРОШО

Содержание объекта данных был возвращен в ответе.

202 Принят

Запрашиваемый диапазон информационного объекта контента был возвращен в ответе.

302 Найден

URI, является ссылкой на другой URI

400 Неверный запрос

Запрос содержит недопустимые параметры или имена полей.

401 Несанкционирован

Полномочия аутентификации отсутствуют или недействительны.

403 Запрещен

Пользователю не хватает надлежащего разрешения на выполнение этого запроса.

404 Не найден

Ресурс не был найден в указанном URI, или запрашиваемое поле не был найден в ресурсе.


8.5.8 Примеры
ПРИМЕР 1 Получить объект данных URI для чтения значения объекта данных:

GET /MyContainer/MyDataObject.txt HTTP/1.1 Host: cloud.example.com

Ниже приведен ответ.

HTTP/1.1 200 OK

Content-Type: text/plain

Content-Length: 37

Это значение этого объекта данных

ПРИМЕР 2 ДОБРАТЬСЯ до объекта данных URI, чтобы прочитать первые 11 байтов значения объекта данных:
GET /MyContainer/MyDataObject.txt HTTP/1.1

Host: cloud.example.com

Range: bytes=0-10
Ниже приведен ответ.
HTTP/1.1 206 Partial Content

Content-Type: text/plain

Content-Range: bytes 0-10/37

Content-Length: 11
8.6 Обновление объекта данных с помощью типа содержимого CDMI
8.6.1 Краткий обзор
Чтобы обновить некоторые или все поля в существующем объекте данных, должен выполняться следующий запрос:

PUT //

Чтобы обновить значение существующего объекта данных, должен выполняться следующий запрос:

PUT //? value:

Для добавления, обновления и удаления элементов метаданных существующего объекта данных, должен выполняться следующий запрос:

PUT //?metadata:;...

Где:

  • это путь к CDMI облако.

  • это ноль или более промежуточных контейнеров.

  • это имя объекта данных необходимо обновить.

  • это диапазон байтов в значении объекта данных необходимо обновить.

Объект данных также должны быть доступны на /cdmi_objectid/, и обновление не должно приводить к изменению идентификатора объекта.
8.6.2 Возможности
Следующие возможности описывают поддерживаемые операций, которые могут быть выполнены при обновлении существующего объекта данных:

Поддержка возможности изменения метаданные существующего объекта данных указывается присутствием cdmi_modify_metadata возможности метаданных в указанном объекте.

Поддержка способности изменять значение существующего объекта данных и / или типа- MIME указывается наличие способности cdmi_modify_value в указанном объекте.

Поддержка способности изменять значение существующего объекта данных в указанных диапазонах байт указывается наличие способности cdmi_modify_value_range в указанном объекте.
8.6.3 Заголовки запросов
Заголовки HTTP запросов для обновления объекта данных, используя тип содержимого CDMI приведены в таблице 21.
Таблица 21 - Заголовки запросов - Обновление объекта данных используя тип содержимого CDMI

Заголовок

Тип

Описание

Требование

Тип содержимого

Заголовок строки

"Применение / CDMI-объект"

Обязательное

X-CDMI-Спецификация-Версия

Заголовок строки

Разделенные запятыми список версий, поддерживаемых клиентом, например, "1.0.2, 1.5,2.0"

Обязательное

X-CDMI-Частичный

Заголовок строки

"правда". Указывает, что объект находится в процессе обновления, и еще не было полностью переработано. При установке, поле completionStatus должен быть установлен в "Обработка".

Если поле completionStatus ранее был установлен на "Обработка", включив в этот заголовок в Создание или обновление, следующее обновление без этой области должны изменить поле completionStatus обратно на "Полный".

Необязательное


8.6.4 Текст сообщения запроса
Текст сообщения запроса для обновления объекта данных, используя тип содержимого CDMI приведены в таблице 22.
Таблица 22 - Текст сообщения запроса - Обновление объекта данных CDMI используя тип содержимого CDMI

Заголовок

Тип

Описание

Требование

Тип МПИР

JSON строка

Данные типа-МПИР, содержащихся в поле значения объекта данных. Если есть, заменяет существующий тип МПИР.

В это поле могут быть включены обновление по значению, десериализация и копирование объектов данных. • Это поле должно быть сохранено как часть объекта. • Если это поле не указан, существующее значение поля Тип -МПИР должен остаться без изменений. • Это поле не должно быть включено при создании ссылки. • Это значение mimetype должен быть преобразован в нижний регистр перед сохранением.

Необязательное

Метаданные

JSON объект

Метаданные для объекта данных. Если он присутствует, новые метаданные, указанные заменяет существующие метаданные объекта. Если отдельные элементы метаданных указаны в URI, только те элементы с другими элементами сохраняются. См. раздел 16 для дальнейшего описания метаданных.

Необязательное

aOnly одно из этих полей должны быть указаны в любой операции. За исключением значения эти поля не должны храниться. Если более чем одно из этих полей поставляется, сервер должен ответить с ответом об ошибке 400 Неверный запрос.


Таблица 22 - Текст сообщения запроса - Обновление объекта данных CDMI используя тип содержимого CDMI

Заголовок

Тип

Описание

Требование

Домен URI

JSON строка

URI-собственник домена

Если отличается от родительского домена, пользователь должен иметь привилегию "cross_domain (см cdmi_member_privileges в таблице 64).

Если не указан, то существующий домен должен быть сохранен.

Необязательное

Десериализовать

JSON строка

URI объекта данных сериализованной CDMI, который должен быть десериализован обновить существующий объект данных. Идентификатор объекта сериализованных данных должно соответствовать идентификатору объекта данных целевого объекта.

Необязательное

Копия

JSON строка

URI объекта данных CDMI или очереди, должны быть скопированы в существующий объект данных.

Необязательное

Десериализовать значение

JSON строка

Объект данных сериализуется как указано в пункте 15 и кодируется с использованием кодировки base64 кодирования правила, описанные в RFC 4648. Идентификатор объекта сериализованных данных должно соответствовать идентификатору объекта данных целевого объекта.

Необязательное

Кодирование значения передачи

JSON массивf JSON строка

Значение передачи, кодирование, используемое для значения объекта данных. Определены два значения кодировки передачи:

«utf-8» указывает, что объект данных содержит допустимую строку UTF-8 и должен перевозиться как строку UTF-8 в поле значения.

• «base64» указывает, что объект данных может содержать произвольные двоичные последовательности и должен перевозиться как базовый 64 закодированную строку в поле значения. Установка содержимого поля значения объекта данных для любого значения, кроме действительной базовой 64 строки должно привести к ошибке 400 Ошибочный запрос, возвращается клиенту. Это поле должно быть включено только при обновлении объекта данных по значению. Если это поле не задано, то существующее значение valuetransferencoding должен быть оставлен без изменений.

Это поле должно быть сохранено как часть объекта.

Необязательное

aOnly одно из этих полей должны быть указаны в любой данной операции. За исключением значения эти поля не должны храниться. Если более чем одно из этих полей поставляется, сервер должен ответить с ответом об ошибке 400 Bad Request.- Неверный запрос ошибки ответа

Каталог: sites -> default -> files
files -> Методические рекомендации по проведению Дня Знаний, посвященного Году кино в РФ
files -> Блестящие будущие возможности в сфере икт для нового поколения женщин
files -> Ларцева А. 1 Перевод имен собственных на примере книги ховарда рейнголда
files -> Занятие №18 Здравствуйте, участники программ личностного развития для детей!
files -> Программа кружка «Юный журналист»
files -> Шелакина А. А. Студентка 2 курса атп 921 ппк сгту имени Гагарина Ю. А
files -> Культурного и природного наследия имени д. С. Лихачева
files -> Участники регионального отборочного Чемпионата профессионального мастерства по методике WorldSkills «WorldSkills Russia Иркутск 2016» по компетенции: 21 PlasteringandDrywallSystems – Сухое строительство и штукатурные работы 25 27
files -> Семинар «использование квест- технологии в обучении английскому языку»


Поделитесь с Вашими друзьями:
1   ...   5   6   7   8   9   10   11   12   ...   33


База данных защищена авторским правом ©nethash.ru 2019
обратиться к администрации

войти | регистрация
    Главная страница


загрузить материал