Skip to main content

Загрузка объектов в контейнер

Метод: PUT

curl -i \$publicURL/marktwain1/text3.txt -X PUT -d "Hello" -H "Content-Type: text/html; charset=UTF-8" -H "X-Auth-Token: \$TOKEN"

Операция PUT создает новый объект в указанной директории. Если эта операция используется для существующего объекта, то существующий объект заменяется на новый. В результате успешной записи нового объекта вернется ответ 201.

Нельзя копировать объекты размером более 5 ГБ.

Пример ответа:

HTTP/2 201
content-length: 0
x-trans-id: tx000000a11ac38f43d3f74-006683b850-315a7e7-v5_zone
x-openstack-request-id: tx000000a11ac38f43d3f74-006683b850-315a7e7-v5_zone
accept-ranges: bytes
content-type: text/plain; charset=utf-8
date: Tue, 02 Jul 2024 08:20:32 GMT

Результат выполнения

В контейнере "marktwain1" создан текстовый файл "text3.txt".

[
{
"name": "marktwain",
"count": 2,
"bytes": 10
},
{
"name": "marktwain1",
"count": 1,
"bytes": 5
},
{
"name": "steven",
"count": 0,
"bytes": 0
},
{
"name": "test",
"count": 2,
"bytes": 73748
},
{
"name": "test3",
"count": 0,
"bytes": 0
}
]

Коды ответов:

  • успешно -- 201

  • с ошибкой -- 404, 408, 411, 422

Параметры запроса

Параметр Тип Формат Описание
account (optional) string path Уникальное имя учетной записи. Учетная запись — это проект или тенант.
container (optional) string path Уникальное (в рамках учетной записи) название контейнера.

Длина названия — от 1 до 256 символов. Название может начинаться с любого символа и должно соответствовать UTF-8. Символ слэша / в названии использовать нельзя, так как он разделяет контейнер и имя объекта.

Например, путь /v1/account/www/pages указывает на контейнер www, а не на www/pages.
object (optional) string path Уникальное название объекта.
X-Auth-Token (optional) string header Токен аутентификации. Если не указать этот заголовок, ваш запрос будет отклонён.
Content-Type (optional) string header Устанавливает MIME-тип (Multipurpose Internet Mail Extension) передачи данных для объектов.

Параметры ответа

Параметр Тип Формат Описание
Date string header Дата и время запроса в формате UTC.
Например: Thu, 16 Jun 2016 15:10:38 GMT
Content-Length string header Если операция выполнена успешно, это значение равно нулю (0) или длине текста ответа об ошибке.
X-Trans-Id string header Уникальный идентификатор (ID) для этого запроса. В случае проблем с сервисом необходимо указать это значение.
X-Openstack-Request-Id string header Уникальный идентификатор операции для этого запроса.
В случае проблем с сервисом необходимо указать это значение.
(То же, что и параметр X-Trans-Id)
Content-Type (optional) string header Устанавливает MIME-тип (Multipurpose Internet Mail Extension) передачи данных для объектов.