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



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

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

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

Описание

201 «Создан»

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

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

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

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

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

403 «Запрещен»

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

404 «Не найден»

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

409 «Неверный»

Имя существующего домена.


10.2.8 Пример
ПРИМЕР Размещение в URI домена и метаданных

PUT /cdmi_domains/MyDomain/ HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-domain

Content-Type: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

{

"metadata" : {



}

}

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

HTTP/1.1 201 Created

Content-Type: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

{


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

"objectID" : "00007E7F00104BE66AB53A9572F9F51E",

"objectName" : "MyDomain/",

"parentURI" : "/cdmi_domains/",

"parentID" : "00007E7F0010C058374D08B0AC7B3550",

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

"capabilitiesURI" : "/cdmi_capabilities/domain/",

"metadata" : {

},

"childrenrange" : "0-1",



"children" : [

"cdmi_domain_summary/",

"cdmi_domain_members/"

]

}


10.3 Чтение объекта домена с помощью типа содержимого CDMI
10.3.1 Краткий обзор
Для чтения поля запрашиваемого доменного объекта осуществляется следующий запрос:

GET /cdmi_domains///

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

GET /cdmi_domains///

?;; . . .

GET /cdmi_domains///?children:;... GET /cdmi_domains///?metadata:
;...


Где:

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

  • < DomainName >ноль или более промежуточных доменных объектов

  • < DomainName > присвоение имени для чтения домена

  • < fieldname > имя поля

  • < range> числовой диапазон первоначальных объектов

  • < prefix>возврат метаданных соответствующие префиксу

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

Чтение метаданных существующего домена возможно при наличии опции cdmi_read_metadata.

Контроль исходных данных существующего домена возможно при наличии опции cdmi_list_children.

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

Данные заголовка

Тип

Описание

Требование

прием

текстовой заголовок

"application/cdmi-domain" согласно пункту 5.13.2

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

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

текстовой заголовок

Список версий, поддерживаемых пользователем, разделяется запятыми. ПРИМЕР. "1.0.2, 1.5, 2.0"

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


10.3.4 Текст сообщения запроса
Текст сообщения запроса не рассматривается
10.3.5 Заголовки ответов
Заголовок ответа для чтения CDMI объекта домена приведен в таблице 72.
Таблица 72 - Заголовки ответов - Чтение объекта домена с помощью типа содержимого CDMI

Данные заголовка

Тип

Описание

Требование

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

текстовой заголовок

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

При отсутствии поддержки любой из версий, сервер определит код статуса 400 «Неверный запрос».


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

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

текстовой заголовок

"application/cdmi-domain"

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

размещение

текстовой заголовок

Поддержка сервером URI.

условное


10.3.6 Текст сообщения ответа
Поле сообщения ответа для чтения домена объекта с CDMI приведено в таблице 73.

Таблица 73 Текст сообщения ответа - Чтение объекта домена, с помощью типа содержимого CDMI



Наименование

Тип

Описание

Требование

Тип объекта

Текстовой заголовок

"application/cdmi-domain"

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

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

Текстовой заголовок

Идентификатор домена

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

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

Текстовой заголовок

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

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

Исходящий URI

Текстовой заголовок

Исходящий URI. Присваивание наименования объекта к исходящему URI.

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

Исходящий идентификатор

Текстовой заголовок

Идентификатор исходящего контейнерного объекта.

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

URI домена

Текстовой заголовок

URI домена. Присваивание домена объекту.

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

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

Текстовой заголовок

Возможности URI объекта.

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

Метаданные

Текстовой заголовок

Метаданные домена. Данное поле включает метаданные и системные данные пользователя, сообщения запроса, вместе с тем и систему хранения метаданных "облако". См. пункт 16.

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

Первоначальный диапазон

Текстовой заголовок

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

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

Первоначальный

Текстовой заголовок

Присваивание имени первоначальному домену. Первоначальные контейнеры разделяются косой чертой "/".

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

Отдельные поля запроса. Дополнительные поля не запрашиваются.


10.3.7 Статус ответа
Коды статуса HTTP чтение домена объекта данных с CDMI приведены в таблице 74.

Таблица 74 Коды статуса HTTP - Чтение объекта домена, с помощью типа содержимого CDMI

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

Описание

200 «OK»

Возврат домена по запросу.

302 «Найден»

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

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

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

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

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

403 «Запрещен»

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

404 «Не найден»

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

406 «Не доступен»

Сервер не доступен.

10.3.8 Примеры
ПРИМЕР 1 Размещение URI для чтения домена

GET /cdmi_domains/MyDomain/ HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

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

Content-Type: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

{


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

"objectID" : "00007E7F00104BE66AB53A9572F9F51E",

"objectName" : "MyDomain/",

"parentURI" : "/cdmi_domains/",

"parentID" : "00007E7F0010C058374D08B0AC7B3550",

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

"capabilitiesURI" : "/cdmi_capabilities/domain/",

"metadata" : {

},

"childrenrange" : "0-1",



"children" : [

"cdmi_domain_summary/",

"cdmi_domain_members/"

]

}



ПРИМЕР 2 Размещение URI для чтения всех исходных URI доменов:

GET /MyDomain/?parentURI;children HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

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

HTTP/1.1 200 OK

Content-Type: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

{

"parentURI" : "/cdmi_domains/",



"children" : [

"cdmi_domain_summary/",

"cdmi_domain_members/"

]

}



ПРИМЕР 3 Размещение URI домена для чтения первоначального домена:

GET /MyDomain/?childrenrange;children:0-1 HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

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

HTTP/1.1 200 OK

Content-Type: application/cdmi-domain

X-CDMI-Specification-Version: 1.0.2

{

"childrenrange" : "0-1",



"children" : [

"cdmi_domain_summary/",

"cdmi_domain_members/"

]

}


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

PUT /cdmi_domains///

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

PUT /cdmi_domains/// ?metadata:;...

Применение:

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

< DomainName >ноль или более промежуточных доменнных объектов

< DomainName > присвоение имени для обновления домена

Доступ объекта на /cdmi_objectid//.Обновление не должно приводить к изменению идентификатора объекта.
10.4.2 Возможности
Ниже приведены поддерживаемые операции для обновления существующего домена:

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

Заголовок

Тип

Описание

Требование

тип контента

текстовой заголовок

"application/cdmi-domain"

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

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

текстовой заголовок

Список версий, поддерживаемых пользователем разделяется запятыми. ПРИМЕР. "1.0.2, 1.5, 2.0"

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


10.4.4 Сообщение запроса
Текст сообщения запроса для обновления доменного объекта с CDMI приведено в таблице 76.
Таблица 76 - Текст сообщения запроса - обновление объекта домена, с помощью типа содержимого CDMI(1 из 2)

Заголовок

Тип

Описание

Требование

метаданные

текстовой заголовок

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

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

копия

текстовой заголовок

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

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

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

текстовой заголовок


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

Идентификатор объекта десериализованного объекта должен соответствовать идентификатору доменного объекта.

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

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

Задается одна из полей данной операции. Данные поля не сохраняются за исключением объема информации.

Каталог: 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   ...   15   16   17   18   19   20   21   22   ...   33


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

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


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