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



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

8.2.5 Текст сообщения запроса
Текст сообщения запроса для создания объекта данных, используя тип содержания CDMI, приведен в таблице 8.
Таблица 8 - Текст сообщения запроса - Создание объекта с помощью данных типа содержания CDMI (Лист 1 из 3)

Имя поля

Тип

Описание

Требование

Тип Многоцелевого Почтового Интернет Расширения (МПИР)

JSON строка


Тип данных МПИР, содержащихся в поле значения объекта данных

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

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

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


Таблица 8 – Текст сообщения запроса - Создание объекта данных, используя тип содержания CDMI (Страница 2 из 3)

Имя поля

Тип

Описание

Требование

Тип Многоцелевого Почтового Интернет Расширения (МПИР)

JSON объект

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

Если это поле включено, при десериализации, сериализации, копировании или перемещении объекта данных, значение приводимые в этой области должны заменить метаданные из источника URI. • Если это поле не входит при десериализации, сериализации, копированиие или перемещении объекта данных, метаданные из источника URI должны использоваться. • Если это поле включено при создании нового объекта данных, указав значение, значение приводимые в этой области должны быть использованы в качестве метаданных. • Если это поле не входит при создании нового объекта данных, указав значение, пустой объект JSON (т.е., "{}"), должны быть назначены в качестве значения поля. • Это поле не должно быть включено при ссылке на объект данных.

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

URI домен

JSON строка

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

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

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

Десериализация

JSON строка

URI из сериализованной CDMI объекта данных, будут десериализованы, чтобы создать новый объект данных

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

Сериализация


JSON строка

URI объекта CDMI, которые должны быть сериализованы в новый объект данных

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

Копия

JSON строка

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

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

Шаг

JSON строка

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

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

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

Ссылка

JSON строка

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

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

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


Таблица 8 - Текст сообщения запроса - Создание объекта данных с помощью типа содержания CDMI (Лист 3 из 3)

Имя поля

Тип

Описание

Требование

Десериализация | значения

JSON строка

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

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

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

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

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

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

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

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

Значение

JSON строка

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

Если это поле не входит в пустой JSON строку (т.е. "") должен быть назначен в качестве значения поля. • Если поле valuetransferencoding указывает UTF-8 кодировку, значение должно быть в кодировке UTF-8 строки избежав с помощью правила побега JSON, описанные в RFC 4627. • Если в поле valuetransferencoding указывает основание 64 кодирования, значение сначала кодируется с помощью базы 64 правила кодирования, описанных в RFC 4648.

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

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


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

Заголовок

Тип

Описание

Требование

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

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

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

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

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

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

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

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


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

Имя поля

Тип

Описание

Требование

Тип объекта

JSON строки

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

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

Объект ID

JSON строки

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

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

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

JSON строки

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

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

Родитель URI

JSON строки

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

Добавление OBJECTNAME к родительскому URI всегда должны производить правильный URI для объекта.

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

Родитель ID

JSON строки

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

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

Домен URI

JSON строки

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

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

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

JSON строки

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

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

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

JSON строки

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

• "Обработка" означает, что объект данных все еще находятся в процессе создания. • "Завершена" указывает, что объект данных был успешно создан. • Строка, которая начинается с "Error" указывает, что ошибка предотвращения создание объекта данных.

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

Полное процентов

JSON строки

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

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

МПИР

JSON строки

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

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

Метаданные

JSON объект

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

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


8.2.8 Статус ответа
Коды состояний HTTP, которые происходят при создании объектов данных, использующих тип содержимого CDMI, описаны в таблице 11.
Таблица 11 - Коды состояния HTTP- Создание объекта данных, используя тип содержимого CDMI

Статус HTTP

Описание

201 Создан

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

202 Принят

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

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

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

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

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

403 Запрещен

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

404 Не найден

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

409 Конфликт

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


8.2.9 Примеры
ПРИМЕР 1 Установить в контейнер URI имя объекта данных и содержание:
Host: cloud.example.com

Accept: application/cdmi-object

Content-Type: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2

{

"mimetype" : "text/plain",



"metadata" : {

},


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

}

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



HTTP/1.1 201 Created

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"

}

}



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

PUT /MyContainer/MyDataObject.txt HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-object

Content-Type: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2

{

"mimetype" : "text/plain",



"metadata" : { },

"valuetransferencoding" : "base64"

"value" : "VGhpcyBpcyB0aGUgVmFsdWUgb2YgdGhpcyBEYXRhIE9iamVjdA=="

}

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



HTTP/1.1 201 Created

Content-Type: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2

{


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

"objectID": "0000706D0010374085EF1A5C7018D774",

"objectName": "MyDataObject.txt",

"parentURI": "/MyContainer/",

"parentID" : "00007E7F00102E230ED82694DAA975D2",

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

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

"completionStatus": "Complete",

"mimetype": "text/plain",

"metadata": {

"cdmi_size": "37"
}

}
8.3 Создание объекта данных, с помощью содержимого типа не-CDMI


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

PUT //

Где:

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

      • равен нулю или более промежуточных контейнеров, которые уже существуют, с одной косой чертой (т.е., "/") между каждой парой имен контейнеров.

      • >это имя указано для объекта данных, которое будет создана.

После того, как будет создан, объект данных должен быть доступен на/cdmi_objectid/.
Каталог: 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   2   3   4   5   6   7   8   9   10   ...   33


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

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


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