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



страница16/33
Дата20.11.2016
Размер4.62 Mb.
Просмотров6925
Скачиваний0
1   ...   12   13   14   15   16   17   18   19   ...   33

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

Коды статуса HTTP

Описание

201 «Создан»

Создан новый объект данных.

202 «Принят»

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


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

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

401 «Не авторизован»

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

403 «Запрещен»

Отсутствие пользовательского разрешения на выполнение данного запроса.

404 «Не найден»

Ресурс не найден в заданном формате URI.

409 «Неверный»

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



9.8.9 Примеры
ПРИМЕР 1 Доступ к контейнерному объекту URI:

POST /MyContainer/ 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" : {

},


"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

Location: http://cloud.example.com/MyContainer/0000706D0010B84FAD185C425D8B537E

{

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



"objectID" : "0000706D0010B84FAD185C425D8B537E",

"objectName" : "0000706D0010B84FAD185C425D8B537E",

"parentURI" : "/MyContainer/",

"parentID" : "0000706D0010B84FAD185C425D8B537E",

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

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

"completionStatus" : "Complete",

"mimetype" : "text/plain",

"metadata" : {

}

}



ПРИМЕР 2 Доступ к идентификатору URI:

POST /cdmi_objectid/ 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",



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

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

}

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

HTTP/1.1 201 Created

Location: http://cloud.example.com/cdmi_objectid/0000706D0010B84FAD185C425D8B537E

Content-Type: application/cdmi-object

X-CDMI-Specification-Version: 1.0.2

{


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

"objectID": "0000706D0010B84FAD185C425D8B537E",

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

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

"completionStatus": "Complete",

"mimetype": "text/plain",

"metadata": {

"cdmi_acl": [

{

"acetype": "ALLOW",



"identifier": "OWNER@",

"aceflags": "NO_FLAGS",

"acemask": "ALL_PERMS"

}

]



}

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


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

POST //

Где:

< root URI> тракт с облако CDMI.

< ContainerName >ноль или более промежуточных контейнерных объектов разделенных косой чертой ("/").

Доступ объекта данных как первоначальный контейнер с присвоенным именем сервера, также как и <корневой URI> / CDMI идентификатор объекта / <объект>.


9.9.2 Возможности
Ниже приведены системные возможности, характеризующие поддерживаемые операции создания нового объекта данных:

Возможность создания объекта данных посредством системных операций «cdmi_post_dataobjec» и «cdmi_create_dataobject»в определенном контейнерном объекте.
9.9.3 Заголовок запроса
Заголовок запроса HTTP для создания нового объекта данных с помощью типа содержимого не-CDMI приведен в таблице 54.
Таблица 54. - Заголовок запроса - создание нового объекта данных с помощью типа содержимого не-CDMI

Ячейка данных

Тип

Описание

Требование

Тип контента

Текстовой

Помещение объекта данных в хранилище как тип контента.

Преобразование объема в нижнем регистре и хранение в поле почтового стандарта CDMI объекта. Если контент имеет параметр кодировки, как RFC 2246 "UTF-8" (например, charset=utf-8"), кодирование поля передачи объекта CDMI устанавливается в "UTF-8". В противном случае, поле кодирования объекта данных CDMI устанавливается в "База 64".

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


9.9.4 Запрос текстового сообщения
Содержание информации об объеме создаваемого объекта данных в запросе текстового сообщения.
9.9.5 Заголовок ответа
Заголовок ответа HTTP для создания нового объекта данных с CDMI приведён в таблице 55.
Таблица 55 - Заголовок ответа HTTP - Создание нового объекта данных с CDMI

Ячейка ответа

Тип

Описание

Требование

размещение

Текстовой

URI новому объекту данных присваивается системой. При отсутствии информации о наименовании файла пользователя, система присваивает URI в виде: <корневой URI> / <Наименование Контейнера> / <Идентификатор объекта>.

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


9.9.6 Текст сообщения ответа
Текст сообщения ответа обеспечивается согласно RFC 2616.
9.9.7 Статус ответа
В таблице 56 приведены Коды статуса HTTP - Создание нового объекта данных с помощью типа содержимого не-CDMI.
Таблица 56 - Коды состояния HTTP - Создание нового объекта данных с помощью типа содержимого не-CDMI.

Коды статуса HTTP

Описание

201 «Создано»

Создан новый объект данных.

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

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

401 «Неавторизованный»

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

403 «Запрещен»

Отсутствие пользовательского разрешения на выполнение данного запроса.

404 «Неверный»

Ресурс не найден в определенном URI.


9.9.8 Примеры
ПРИМЕР 1 Запрос контейнерного объекта URI:

POST /MyContainer/ HTTP/1.1

Host: cloud.example.com

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





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

HTTP/1.1 201 Created

Location:http://cloud.example.com/MyContainer/0000706D0010B84FAD185C425D8B537E

ПРИМЕР 2 Определение идентификатора объекта:

POST /cdmi_objectid/ HTTP/1.1

Host: cloud.example.com

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





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

HTTP/1.1 201 Created

Location: http://cloud.example.com/cdmi_objectid/0000706D0010B84FAD185C425D8B537E
9.10 Создание (пост) нового объекта очереди с помощью типа содержимого CDMI
9.10.1 Краткий обзор
Для создания нового объекта в определенном контейнере, где идентификатор объекта присвоен сервером, выполняется следующий запрос: (см. пункт 11)

POST //

Для создания нового объекта очереди не принадлежащий контейнеру и доступному идентификатору объекта, выполняется следующий запрос: (см 5.8)

POST /cdmi_objectid/



Где:

  • < root URI> связь с CDMI.

  • < ContainerName > ноль или более промежуточных контейнерных объектов, разделяются косой чертой ("/").

Если создан в "/ cdmi_objectid /", объект очереди должны быть доступны в <корень URI> / cdmi_objectid / .

Если созданный объект очереди доступен как первоначальный объект с идентификатором присвоенным сервером, объект также будет доступен в формате >/cdmi_objectid/ .
9.10.2 Отложенное завершение создания
При создании объекта очереди, сервер возвращает статус ответа 202 «Принято». В данном случае объект находится в процессе создания. Данный статус является важным при длительной системной операции, например, копирование большого объема источника URI. Данный ответ имеет следующие значения:

  • Возврат запроса объекта URI с кодом HTTP 202 «Принято» сервером.

  • Код HTTP 202 «Принято» обозначает сервером прохождение проверки:

- Доступ пользователя к созданию объекта;

- Доступ пользователя к чтению, перемещению, копированию, остановке и преобразованию любого источника объекта;

- Наличие пространства для создания объекта URI или сообщения ошибки.

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

Пользователь выполняет системные операции URI для отслеживания прогресса операции. В результате прохождения операции, сервер возвращает поле сообщения ответа.

Поле сообщения имеет статус "Обработка", "Завершен" или "Ошибка".

Поле завершения содержит процентное содержание (от 0 до 100).

Системная операция не возвращает объем объекта при статусе «Не завершен».

Если при завершении операции обнаружена ошибка, URI создается в поле сообщения об ошибке. Удаление URI ошибки остается за пользователем.
9.10.3 Возможности
Идентификатором объекта /7cdmi_objectid/ могут выполняться следующие системные возможности поддерживаемых операций создания нового объекта:

  • Cоздание объекта очереди, возможно наличием системной операции cdmi_post_queue_by_ID.

  • Если объект создается в формате 7 HDMI ObjectID / и является ссылкой, поддержка данной операции возможна с системой cdmi_create_reference_by_ID.

  • Если объект создается в формате 7 HDMI ObjectID / и является копией, поддержка данной операции возможна с системой cdmi_copy_queue_by_ID.

  • Если объект создается в формате 7 HDMI ObjectID / и предназначается для перемещения данных, поддержка данной операции возможна с системой cdmi_object_move_to_ID.

  • Если объект создается в формате 7 HDMI ObjectID / и предназначается для преобразования данных, поддержка данной операции возможна с системой cdmi_deserialize_queue_by_ID.

Для создания нового очередного объекта идентификатором поддерживаются следующие системные операции:

  • Cоздание очередного объекта, возможно наличием системных операций cdmi_post_queue и cdmi_create_queue в определенном контейнерном объекте.

  • Если объект очереди является ссылкой предыдущего объекта, данная операция поддерживается наличием CDMI «cdmi_create_reference» в исходном контейнерном объекте.

  • Если объект очереди является копией, поддержка данной операции возможна с системой cdmi_copy_queue в исходном контейнерном объекте.

  • Если объект очереди предназначается для перемещения данных, поддержка данной операции возможна с системой cdmi_move_queue в исходном контейнерном объекте.

  • Если объект очереди предназначается для преобразования данных, поддержка данной операции возможна с системой cdmi_deserialize_queue в исходном контейнерном объекте.


9.10.4 Заголовки запросов
Заголовки запросов HTTP для создания объекта очереди, с помощью типа содержимого CDMI приведены в таблице 57.
Таблица 57 Заголовки запросов- Создание объекта очереди, с помощью типа содержимого CDMI

Заголовок

Тип

Описание

Требование

Прием

текстовой

"application/cdmi-queue" совместимый объем по пункту 5.13.2

дополнительное

Контентный тип

текстовой

"application/cdmi-queue"

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

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

текстовой

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

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


9.10.5 Текст сообщения запроса
Текст сообщения запроса для создания объекта очереди, с помощью типа содержимого CDMI приведен в таблице 58.
Таблица 58 Текст сообщения запроса для создания объекта очереди, с помощью типа содержимого CDMI

Наименование файла

тип

описание

требование

метаданные

текстовой

Метаданные для объекта очереди:

Если поле сообщения включено во время преобразования, копировании или перемещении очередного объекта, объем данных заменяется метаданными URI источника.

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

Если данное поле не включено при создании нового объекта, распределяется определенный объект нотаций.

Данное поле не включается при ссылке на объект.


дополнительное

URI домен

текстовой

URI домен

Определение домена, привилегии пользователя домена не требуются (см.таблицу 64).

Если не определен корневой домен может использоваться домен CDMI.


дополнительное

преобразование

текстовой

Идентификатор CDMI объекта данных может быть изменен для создания нового объекта очереди.

дополнительное

копия

текстовой

Идентификатор CDMI объекта, может быть скопирован в новый объект очереди.

дополнительное

перемещение

текстовой

Идентификатор CDMI объекта, может быть скопирован в новый объект очереди.

При успешном копировании объект удаляется из источника URI.



дополнительное

ссылка

текстовой

URI CDMI объекта перенаправляются ссылкой. Сервер отмечает код статуса HTTP 400 «Неверный запрос» при ссылках других полей.

дополнительное

объем преобразования

текстовой

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

дополнительное

Задается одна из полей данной операции. Данные поля не сохраняются за исключением объема информации. Если определены более одного поля, сервер задает об ошибке 400 «Неверный запрос».

Каталог: 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   ...   12   13   14   15   16   17   18   19   ...   33


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

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


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