9.3.1 Обзор
Для создания нового объекта-контейнера следует выполнить запрос:
PUT <root URI>/<ContainerName>/<NewContainerName>/
где:
- <root URI> путь к облаку CDMI;
- <ContainerName> неотрицательное число уже существующих объектов-контейнеров, имена которых разделены символами наклонной черты (т.е., "/");
- <NewContainerName> имя создаваемого контейнера.
После создания к контейнеру можно обращаться как <root URI>/cdmi_objectid/<objectlD>/.
Наличие завершающей наклонной черты в URI, по которому выполняется операция PUT, указывает на создание объекта-контейнера, в отличие от создания объекта данных.
9.3.2 Опции
Следующие опции описывают поддерживаемые операции при создании нового объекта:
- поддержка возможности создания нового объекта-контейнера обозначается наличием опции cdmi_create_container в родительском контейнере.
9.3.3 Заголовки запроса
Сообщение-запрос может содержать заголовки, соответствующие RFC 2616.
9.3.4 Тело сообщения-запроса
Тело запроса должно отсутствовать.
9.3.5 Заголовки ответа
Сообщение-ответ может содержать заголовки, соответствующие RFC 2616.
9.3.6 Тело сообщения-ответа
Сообщение-ответ может содержать тело, соответствующее RFC 2616.
9.3.7 Статус запроса
В таблице 37 приведены коды состояний HTTP, возникающих при создании объекта-контейнера с использованием типа содержимого, отличного от CDMI.
Таблица 37 - Коды состояний HTTP - создание объекта-контейнера с использованием типа содержимого, отличного от CDMI
Статус HTTP | Описание |
201 Created | Новый объект-контейнер был создан |
400 Bad Request | Запрос содержит неверные параметры или имена полей |
401 Unauthorized | Неверные данные аутентификации/авторизации. |
403 Forbidden | Клиент не обладает правами для выполнения данного запроса. |
409 Conflict | Контейнер с таким именем уже существует. |
9.3.8 Пример
Пример - Применение PUT к URI имени объекта-контейнера: