8.3.1 Обзор
Для создания объекта данных следует выполнить следующий запрос:
PUT <root URI>/<ContainerName>/<DataObjectName> 2
где:
- <root URI> путь к облаку CDMI;
- <ContainerName> неотрицательное число уже существующих промежуточных контейнеров, разделенных наклонной чертой (т.е., "/");
- <DataObjectName> имя создаваемого объекта данных.
После создания к объекту данных можно обращаться как <root URI>/cdmi_objectid/<objectlD>.
8.3.2 Опции
Следующие опции описывают поддерживаемые операции, которые можно выполнять при создании нового объекта данных:
- поддержка возможности создания нового объекта данных обозначается присутствием опции cdmi_create_dataobject в родительском контейнере.
8.3.3 Заголовки запроса
Заголовки HTTP запроса на создание объекта данных CDMI с использованием типа содержимого, отличного от CDMI, приведены в таблице 12.
Таблица 12 - Заголовки запроса - создание объекта данных CDMI с использованием типа содержимого, отличного от CDMI
Заголовок | Тип | Описание | Требование |
Content-Type | Строка заголовка | Тип содержимого данных, которые должны храниться в объекте данных. Указанное здесь значение должно использоваться как поле mimetype объекта данных CDMI. Если тип содержимого включает параметр charset (RFC 2046), равный "utf-8" (например, ";charset=utf-8"), поле valuetransferencoding объекта данных CDMI должно быть установлено в "utf-8". В ином случае, поле valuetransferencoding объекта данных CDMI должно быть установлено в "base64". | Обязательно |
X-CDMI-Partial | Строка заголовка | "true" указывает на то, что новый объект является частью набора операций записи, и что его значение еще заполнено не полностью. Поле completionStatus будет установлено в "Processing". | Опционально |
8.3.4 Тело сообщения-запроса
Тело сообщения-запроса содержит данные, которые должны храниться как значение объекта данных.
8.3.5 Заголовки ответа
Заголовки ответа не определены.
8.3.6 Тело сообщения-ответа
Поля сообщения-ответа не определены.
8.3.7 Статус ответа
Коды состояний HTTP, возникающих при создании объекта данных с использованием содержимого, отличного от CDMI, описаны в таблице 13.
Таблица 13 - Коды состояния HTTP - создание объекта данных CDMI с использованием типа содержимого, отличного от CDMI
Статус HTTP | Описание |
201 Created | Новый объект данных был создан. |
400 Bad Request | Запрос содержит неверные параметры или имена полей. |
401 Unauthorized | Неверные данные аутентификации/авторизации. |
403 Forbidden | Клиент не обладает правами для выполнения данного запроса. |
404 Not Found | Ресурс не найден по указанному URI. |
409 Conflict | Операция конфликтует с блокировкой не-CDMI протокола доступа или может вызвать ошибку передачи на сервер. |