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



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

8.3.2 Возможность
Ниже описаны возможности, поддерживаемые операции, которые могут быть выполнены при создании нового объекта данных:

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

Таблица 12 - Заголовки запросов - Создание объекта данных CDMI, с помощью типа содержимого не-CDMI

Заголовок

Тип

Описание

Требование

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

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

Тип содержимого данных, хранимый в объекте данных. Указанное здесь значение должно использоваться в качестве поля типа МПИР объекта данных CDMI. Если тип контента включает в себя параметр кодировки, как определено в RFC 2046 в "UTF-8" (например, "; кодировка = UTF-8"), поле кодирования передачи значения объекта данных CDMI должен быть установлен в "UTF-8". В противном случае, поле кодирования передачи значения объекта данных CDMI должен быть установлен в "base64".

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

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

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

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

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


8.3.4 Запрос текста сообщения
Текст сообщения запроса содержит данные, которые будут сохранены в значении объекта данных.

8.3.5 Заголовки ответов
Никакие заголовки ответов не указаны.
8.3.6 Текст ответа сообщения
Никакие поля текста ответного сообщения не указаны.
8.3.7 Статус ответа
Коды состояния HTTP, которые происходят при создании объекта данных, используя тип содержимого не-CDMI описаны в таблице 13.
Таблица 13 - Коды состояния HTTP- Создание объекта с помощью данных типа содержимого не-CDMI

HTTP статус

Описание

201 Создан

Новый объект данных был создан.

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

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

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

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

403 Запрещен

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

404 Не найден

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

409 Конфликт

Операция конфликтует с замком протокола доступа не-CDMI или может привести к ошибке перехода на сервере.


8.3.8 Пример
ПРИМЕР Установить в контейнер URI имя объекта данных и содержание:

PUT /MyContainer/MyDataObject.txt HTTP/1.1



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

Host: cloud.example.com

Content-Type: text/plain;charset=utf-8

Content-Length: 37

This is the Value of this Data Object

The following shows the response.

HTTP/1.1 201 Created
8.4 Чтение данных объекта с помощью типа содержимого CDMI
8.4.1 Краткий обзор
Чтобы прочитать все поля из существующего объекта данных, осуществляется следующий запрос:

GET //



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

GET //?; ;...

GET //?value: ;...

GET //?metadata:


;...

Где:

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

  • равен нулю или более промежуточных контейнеров. это имя объекта данных для чтения из. это имя поля.

  • это диапазон байт значения объекта возвращаемых данных в поле значения.
    это префикс соответствия, который возвращает все элементы метаданных, которые начинаются со значением префикса.

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

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

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

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


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

Заголовок

Тип

Описание

Требование

Принимать

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

"Применение / CDMI-объект" или последовательное значение в соответствии с п. 5.13.2

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

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

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

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

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


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

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

Заголовок

Тип

Описание

Требование

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

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

Сервер должен ответить с самой высокой версии, поддерживаемой как клиентом так и сервером, например, "1.0.2".

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

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

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

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

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

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

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

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

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

Условное


8.4.6 Текст сообщения ответа
Поля текста сообщения ответа для чтения объекта данных, тип содержимого CDMI приведены в таблице 16.
Таблица 16 - Текст сообщения ответа - Чтение объекта данных, используя тип содержимого CDMI (Лист 1 из 3)

Заголовок

Тип

Описание

Требование

Тип объекта

JSON строка

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

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

объект ID

JSON строка

Объект Идентификатора объекта

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

Наименование объекта

JSON строка

Название объекта

Для объектов в контейнере, Название объекта поле должен быть возвращен.

Для объектов, не в контейнере (объекты, которые доступны только с помощью ID), Название объекта поле не существует и недолжен быть возвращен.

Условное


Таблица 16 - Текст сообщения ответа - Чтение объекта данных, используя тип содержимого CDMI (Лист 2 из 3)

Заголовок

Тип

Описание

Требование

Родитель URI

JSON строка

URI для родительского объекта

Для объектов в контейнере, родительское поле URI должен быть возвращен. • Для объектов, не в контейнере (объектов, которые доступны только с помощью ID), родительское поле URI не существует, и не должны быть возвращены. Добавление названия к родительском URI всегда будет производить действительный URI для объекта.

Условное

Родитель ID

JSON строка

Объект Идентификатора объекта родительского контейнера

Для объектов в контейнере, родительское поле ID должен быть возвращен. • Для объектов, не в контейнере (объекты, которые доступны только с помощью ID), родительское поле ID не существует, и не должен быть возвращен.

Условное

Домен URI

JSON строка

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

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

Возможности URI

JSON строка

URI к возможностям для объекта

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

Статус завершения

JSON строка

Строка, указывающая, если объект все еще находится в процессе создания, и после завершения операции, если она была создана успешно или произошла ошибка.

Значение должно быть строкой "Обработка", строка "Завершить", или строка ошибки начиная со значения "Error".

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

Процент завершения

JSON строка

Если значение Статус завершения является «Обработка», в этом поле, если это предусмотрено, будет указан процент выполнения как числовое целое значение от 0 до 100.

• Если значение Статус завершения является "Полный", в этом поле, если это предусмотрено, будет содержать значение "100".

• Когда значение Статус завершения это сообщение "Error", это поле, если это предусмотрено, может содержить любое целое значение от 0 до 100.

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

Тип- МПИР

JSON строка

Тип МПИР значения объекта данных

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

Метаданные

JSON объект

Метаданные для объекта данных

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

См. раздел 16 для дальнейшего описания метаданных.

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


Таблица 16 - Текст сообщения ответа - Чтение объекта данных, используя тип содержимого CDMI (Лист 3 из 3)

Заголовок

Тип

Описание

Требование

Диапазон значений

JSON строка

Диапазон байтов объекта данных должны быть возвращены в поле значения

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

• Если объект значения имеет пробелы (из-за PUTs с диапазоном значений вразбивку), диапазон значенийбудет показывать диапазон до первого пробела в значении объекта.

• Система метаданных хранения cdmi_size объекта данных всегда указывает полный размер объекта, в том числе нулевой пробел.

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

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

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

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

• "UTF-8" означает, что объект данных содержит действительный UTF-8 строку, и оно будет перевозиться в UTF-8 строку в поле значений. • "base64" означает, что объект данных может содержать произвольные двоичные последовательности, и оно должно перевозиться в качестве базы 64-закодированной строки в поле значений.

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

Значение

JSON строка

Значение объекта данных

Если поле кодирования значении передачи указывает UTF-8 кодировку, то значение поля должно содержать UTF-8 строку, используя JSON побега правила, описанные в RFC 4627.

• Если поле кодирования значении передачи будет содержат базовую строку кодировки 64, то значение поля должно содержать базу 64-кодированную строку, как описано в RFC 4648.

• Поле значения должен быть предоставлен только в том случае, когда Статус завершения "Полный"- «Complete».

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

Условное


Если отдельные поля указаны в запросе GET, только эти поля будут возвращены в результате текста. Дополнительные поля, которые запрашиваются, но не существующие исключены из результатов текста.
8.4.7 Статус ответа
Коды состояния HTTP, которые происходят при чтении данных с помощью объекта типа содержимого CDMI описаны в таблице 17.
Таблица 17 - Коды состояния HTTP - Чтение объекта данных CDMI, используя тип содержимого CDMI

Статус HTTP

Описание

200 ХОРОШО

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

202 Принят

Объект данных в процессе создания. Клиент CDMI должен контролировать поля Статуса завершения и Процент завершения, определить текущее состояние работы.

302 Найден

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

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

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

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

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

403 Запрещен

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

404 Не найден

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

406 Недопустим

Сервер не в состоянии обеспечить в тип содержимого объекта, указанного в заголовке Accept.


Каталог: 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   ...   4   5   6   7   8   9   10   11   ...   33


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

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


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