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



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

9.4.6 Текст сообщения ответа
Тексты сообщения ответов для чтения объекта контейнера CDMI, с помощью типа содержимого CDMI, приведены в таблице 40.
Таблица 40 - Текст сообщения ответа - Чтение объекта контейнера, с помощью типа содержимого CDMI (лист 1 из 2)

Имя поля

Тип

Описание

Требование

Объект

JSON строка

«применение/CDMI контейнер»

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

Объект ID

JSON строка

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

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

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

JSON строка

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

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

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

Условное

Родитель URI

JSON строка

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

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

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

Условное

Родитель ID

JSON строка

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

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

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

Условное

Домен URI

JSON строка

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

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

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

JSON строка

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

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

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

JSON строка

Строка, указывающий, если объект находится все еще в процессе создания, и после завершения операции, возвращается, если он был успешно создан или произошла ошибка. Значение должно быть строкой "Processing", строка "Complete", или строка ошибки, начиная со значения "Error".

Обязательный

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

JSON строка

Когда значение completionStatus это "Processing", это поле, если, указывают процент завершения как числовой целочисленное значение от 0 до 100.

Когда значение completionStatus это "Complete", это поле, если предусмотрено, должен содержать значение «100».

Когда значение completionStatus это "Error", это поле, если, может содержать любое целочисленное значение от 0 до 100.

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

aВозвращается только при наличии.


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

Имя поля

Тип

Описание

Требование

Метаданные

JSON объект

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

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

Экспорт

JSON объект

Структура для каждого протокола, включенного для этого объекта контейнера (см. пункт 13)

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

Снимки

Массив

JSON

Коды снимков объектов контейнера URI

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

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

JSON строка

Исходные контейнера, выражается в виде диапазона. Если запрашивается диапазон исходных, это поле указывает, что исходные возвращаются в виде диапазона.

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

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

МассивJSON

Названия исходных объектов в объектах контейнера. Названия всех исходных должны быть зарезервированные знаки, преобразуются в соответствии со стандартом RFC 3986, например, заменить символ «%» в названии «% 25».

Исходные, которые являются объектами контейнера должны иметь «/» и добавляются к дочернему названию.

• Исходные, которые являются ссылками должны иметь «?» и добавляются к первоначальному названию.

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

aВозвращается только при наличии.

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

Статус HTTP

Описание

200 ХОРОШО

Метаданные для объекта контейнера содержится в тексте сообщения.

302 Найден

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

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

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

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

Учетные данные проверки подлинности отсутствуют или являются недопустимыми.

403 Запрещен

Клиент не имеет надлежащего разрешения для выполнения этого запроса.

404 Не найден

Ресурс не найден по указанному URI

406 Не приемлем

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


9.4.8 Примеры
ПРИМЕР 1 Получение объекта контейнера URI для чтения всех полей объекта-контейнера:

GET /MyContainer/HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-container

X-CDMI-Specification-Version: 1.0.2

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

HTTP/1.1 200 OK

Content-Type: application/cdmi-container

X-CDMI-Specification-Version: 1.0.2

{

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



"objectID" : "0000706D0010B84FAD185C425D8B537E",

"objectName" : "MyContainer/",

"parentURI" : "/",

"parentID" : "00007E7F0010128E42D87EE34F5A6560",

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

"capabilitiesURI" : "/cdmi_capabilities/container/",

"completionStatus" : "Complete",

"metadata" : {

},

"exports" : {



"OCCI/iSCSI": {

"identifier": "00007E7F00104BE66AB53A9572F9F51E",

"permissions": [

"http://example.com/compute/0/",

"http://example.com/compute/1/"

]


},

"Network/NFSv4" : {

"identifier" : "/users",

"permissions" : "domain"

},

"childrenrange" : "0-4",



"children" : [

"red",


"green",

"yellow",

"orange/",

"purple/"

]

}

}



ПРИМЕР 2 Получение объекта контейнера URI для чтения parentURI и исходных объекта-контейнера:

GET /MyContainer/?parentURI;children HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-container

X-CDMI-Specification-Version: 1.0.2
Ниже приведен ответ.

HTTP/1.1 200 OK

Content-Type: application/cdmi-container

X-CDMI-Specification-Version: 1.0.2

{

"parentURI" : "/",



"children" : [

"red",


"green",

"yellow",

"orange/",

"purple/"

]

}

ПРИМЕР 3 Получение объекта контейнера URI для чтения первоначальной версии, 0.. 2 и ряда ячеек контейнерного объекта:



GET /MyContainer/?childrenrange;children:0-2 HTTP/1.1

Host: cloud.example.com

Accept: application/cdmi-container

X-CDMI-Specification-Version: 1.0.2



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

HTTP/1.1 200 OK

Content-Type: application/cdmi-container

X-CDMI-Specification-Version: 1.0.2

{

"childrenrange" : "0-2",



"children" : [

"red",


"green",

"yellow"

]

}
9.5 Обновление объекта контейнера с помощью типа содержимого CDMI


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

PUT ///



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

PUT /// ?metadata: ;...



Область применения:

  • <корень URI> - тракт с CDMI облака.

  • <наименование контейнера> - ноль или более промежуточных контейнерных объектов.

  • <наименование контейнера> - наименование обновленного контейнера.

Доступ контейнерного объекта на <root UR>/>/. Обновление не должно приводить к изменению назначения объекта.
9.5.2 Отложенные данные
В случае необходимости создания цифровых данных запрашивается сообщение с запросом сервера о возврате кода статуса HTTP «Принято» 202 (см. раздел 14). Данная операция имеет следующие значения:

- Прохождение проверки данных сервером статуса 202:

- Авторизация пользователя для создания данных,

- Авторизация пользователя для доступа к чтению контейнерного объекта,

- Наличие доступного пространства для создания данных или наличие пространства для определения ошибки.

Из-за задержек обеспечения согласованности использования данных пользователь не может получить быстрый доступ к файлу. Пользователь создает данные URI для отслеживания прогресса выполненных операций. Поле сообщения может иметь статус "Обработка", "Завершенный" или статус «Ошибка». Дополнительное поле содержит процент от 0 до 100. Чтение данных не доступно в случае не завершенного статуса. В случае ошибочного окончательного результата операции данные URI создаются в дополнительном поле текстового сообщения об ошибке. Данная операция остается за пользователем.
9.5.3 Возможности
Ниже приведены функциональные возможности контейнерного объекта, характеризующие поддерживаемые системные операции выполнения и обновления:

  • Изменение метаданных контейнерного объекта, возможно при наличии метаданных функциональных возможностей определенного контейнера;

  • Снимок содержания определенного контейнерного объекта;

  • Добавление протокола к существующему контейнерному объекту.


9.5.4 Заголовки запросов
Запрос HTTP данных для обновления контейнерного объекта с CDMI приведен в таблице 42.
Таблица 42 – Заголовки запросов- Обновление объекта контейнера с помощью типа содержимого CDMI

имя файла

тип

описание

требование

тип контента

текстовой

"применение/cdmi-контейнер"

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

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

текстовой

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

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


9.5.5 Текст сообщения запроса
В таблице 43 приведен текст сообщения запроса для обновления контейнерного объекта с CDMI.
Таблица 43 - Текст сообщения запроса - Обновление контейнерного объекта с помощью типа содержимого CDMI(1 из 2)

имя файла

тип

описание

требование

Метаданные

объект JSON

Метаданные для контейнерного объекта. Новые метаданные заменяют существующие метаданные объекта.

Определение отдельных элементов метаданных URI и замена их другими сохраняемыми элементами.

(см. пункт 16).

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

Домен URI

объект JSON

Домен URI

В случае изменения исходного домена, пользователь должен иметь междоменную привилегию. (Привилегии членам CDMI приведены в таблице 64).

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

Зафиксированные данные

объект JSON

Заключительным компонентом успешного окончания операции являться наименование файла.

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

Зафиксированные данные будут доступны как первоначальные данные контейнерного объекта.



Новый файл с именем существующего файла заменяется предыдущим файлом.

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

Приостановка передачи команд 

объект JSON

Преобразованная форма контейнерного объекта с CDMI, приостанавливается для обновления существующего объекта.

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

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

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



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

Копия

объект JSON

Копия контейнерного объекта с 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   ...   9   10   11   12   13   14   15   16   ...   33


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

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


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