Swift

С помощью Swift API (API на базе OpenStack Object Storage API) вы можете работать с ресурсами S3:

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

Для доступа к Swift API у пользователя должна быть роль с доступом к проекту в S3, подробнее в инструкции документации Управлять доступом в S3.

Авторизация

Авторизация в Swift API происходит с помощью IAM-токен для проекта, который передается в каждом запросе в заголовке X-Auth-Token.

Адрес (URL) можно посмотреть в списке URL.

Пример запроса для просмотра списка бакетов в проекте аккаунта:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>'

Укажите:

<x_auth_token> — IAM-токен для проекта;
<swift_domain> — домен Swift API в пуле, в котором находится S3;
<project_id> — идентификатор проекта. Посмотреть идентификатор можно в панели управления в разделе S3 → меню проектов → Управление проектами. Идентификатор указан под названием проекта.

Хранилище

HEAD	/v1/{project_id}	Получение информации о хранилище
GET	/v1/{project_id}	Получение информации о хранилище и списка бакетов
POST	/v1/{project_id}	Управление метаданными хранилища

Получить информацию о хранилище

Возвращает метаданные с информацией о количестве и объеме хранения бакетов и объектов.

Пример запроса

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>'

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

В случае успеха запрос возвращает ответ с кодом 204.

HTTP/1.1 204 No Content
Content-Length: 0
X-Account-Object-Count: 6
X-Timestamp: 1374058535.42927
X-Account-Meta-Temp-Url-Key: 00000
X-Account-Bytes-Used: 484474
X-Account-Container-Count: 3
X-Account-Meta-<...>: anyheader
X-Openstack-Requiest-Id: 0009ec57-2681-4b48-9105-71c57016edc6
X-Trans-Id: 0009ec57-2681-4b48-9105-71c57016edc6

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

Параметр	Значение
X-Account-Bytes-Used	Суммарный объем хранимых данных (в байтах)
X-Account-Container-Count	Количество бакетов
X-Account-Meta-<...>	Метаданные, где <...> — пользовательский заголовок
X-Account-Meta-Temp-Url-Key	Секретный ключ, который используется для доступа к объектам в приватном бакете через временный URL (при наличии)
X-Account-Object-Count	Общее количество хранимых объектов
X-Account-Storage-Policy-Policy-0-Bytes-Used	Суммарный объем хранимых данных по политике хранения, где Policy-0 — имя политики
X-Account-Storage-Policy-Policy-0-Container-Count	Количество бакетов, которые используют политику хранения, где Policy-0 — имя политики
X-Account-Storage-Policy-Policy-0-Object-Count	Количество объектов, которые используют политику хранения, где Policy-0 — имя политики
X-Openstack-Request-Id X-Trans-Id	ID запроса
X-Timestamp	Дата и время в UNIX-формате, когда был создан аккаунт, бакет или объект
Date	Дата и время отправки запроса

Получить информацию о хранилище и список бакетов

Возвращает информацию о хранилище и список бакетов.

Один запрос выводит список, который может содержать до 10 000 бакетов. Если бакетов больше, используйте дополнительные запросы с query-параметром marker.

Чтобы получить дополнительную информацию о бакетах (размер, дату обновления и т. д.), используйте query-параметр ?format=json.

Пример запроса

curl \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>'

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

bucket1
bucket2
bucket3

Управлять метаданными хранилища

Устанавливает, заменяет или удаляет метаданные, переданные в заголовке из запроса.

Заголовки запроса

Заголовок	Описание
X-Account-Meta-<...>	Метаданные хранилища, которые будут установлены, где <...> — пользовательский заголовок
X-Remove-Account-Meta-<...>	Метаданные хранилища, которые требуется удалить, где <...> — пользовательский заголовок

Пример запроса

curl -i -XPOST \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Account-Meta-<...>: anyheader' \
'https://<swift_domain>/v1/<project_id>'

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

В случае успеха запрос возвращает ответ с кодом 204.

Бакеты

HEAD	/v1/{project_id}/{bucket_name}	Получение метаданных бакета
GET	/v1/{project_id}/{bucket_name}	Получение списка объектов и метаданных бакета
PUT	/v1/{project_id}/{bucket_name}	Создание бакета
POST	/v1/{project_id}/{bucket_name}	Управление метаданными бакета
DELETE	/v1/{project_id}/{bucket_name}	Удаление бакета

Получить метаданные бакета

Выводит метаданные бакета, включая количество объектов, объем хранения (в байтах) и заголовки бакета.

Пример запроса

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>'

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

В случае успеха запрос возвращает ответ с кодом 204.

Получить список объектов и метаданных бакета

Возвращает метаданные бакета и выводит список объектов.

Один запрос выводит список, который может содержать до 10 000 объектов. Если объектов больше, используйте дополнительные запросы с query-параметрами marker и limit.

Пример запроса

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>'

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

В случае успеха запрос возвращает ответ с кодом 200 или 204.

HTTP/1.1 200 OK
Accept-Ranges: bytes
Content-Type: text/plain
X-Container-Bytes-Used: 0
X-Container-Meta-Quota-Bytes: 52428800
X-Container-Meta-Quota-Count: 1000
X-Container-Meta-Type: public
X-Container-Object-Count: 1
X-Container-Storage-Policy-Index: 0
X-Container-Storage-Policy-Name: Policy-0
X-Openstack-Request-Id: 585ec880-d654-485f-949e-c0dc24926d00
X-Storage-Policy: Policy-0
X-Timestamp: 1688648194.11923
X-Trans-Id: 585ec880-d654-485f-949e-c0dc24926d00
X-Versions-Enabled: true
Date: Thu, 13 Jul 2023 15:13:53 GMT
Content-Length: 120

Object1
Object2
Object3

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

Параметр	Значение
X-Container-Object-Count	Количество объектов в бакете
X-Container-Bytes-Used	Объем объектов в бакете (в байтах)
X-Container-Meta-Type	Тип бакета
X-Container-Meta-Quota-Bytes	Максимальный объем хранения данных (в байтах)
X-Container-Meta-Quota-Count	Максимальное количество объектов в бакете
X-Container-Meta-<...>	Метаданные бакета, где <...> — пользовательский заголовок
X-Versions-Enabled	Включено ли версионирование бакета

Создать бакет

Создает бакет с параметрами, указанными в запросе.

Заголовки запроса

Заголовок	Описание
X-Container-Meta-Type	Тип бакета: public (публичный); private (приватный)
X-Container-Meta-<...>	Метаданные бакета. Укажите \<...> — заголовок метаданных
X-Storage-Policy	Класс хранения: Policy-0 (по умолчанию) — стандартное хранение; cold — холодное хранение
X-Versions-Enabled	Включено ли версионирование бакета
X-Container-Meta-Default-Delete-After	Срок хранения всех объектов в бакете (в секундах)

Пример запроса

curl -i -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Container-Meta-Type: public' \
-H 'X-Container-Meta-<...>: anyheader' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>'

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

В случае успеха запрос возвращает ответ с кодом 201.

HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html
X-Openstack-Requiest-Id: 0009ec57-2681-4b48-9105-71c57016edc6
X-Trans-Id: 0009ec57-2681-4b48-9105-71c57016edc6

Управлять метаданными бакета

Устанавливает, заменяет или удаляет метаданные, переданные в заголовке из запроса.

Заголовки запроса

Заголовок	Описание
X-Container-Meta-Type	Тип бакета: public (публичный); private (приватный)
X-Container-Meta-<...>	Метаданные бакета, которые будут установлены, где <...> — пользовательский заголовок
X-Remove-Container-Meta-<...>	Метаданные бакета, которые требуется удалить, где <...> — пользовательский заголовок
X-Versions-Enabled	Включено ли версионирование бакета

Пример запроса

Изменение типа бакета:

curl -i -XPOST \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Container-Meta-Type: private' \
-H 'X-Versions-Enabled: true' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>'

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

В случае успеха запрос возвращает ответ с кодом 204.

Удалить бакет

Удаляет бакет в хранилище. Перед удалением бакета удалите в нем все объекты.

Пример запроса

curl -i -XDELETE \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>'

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

В случае успеха запрос возвращает ответ с кодом 204.

HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: Text/html; charset=UTF-8

Объекты

GET	/v1/{project_id}/{bucket_name}/{object_name}	Получение объекта
PUT	/v1/{project_id}/{bucket_name}/{object_name}	Загрузка объекта
POST	/v1/{project_id}	Удаление нескольких объектов
POST	/v1/{project_id}/{bucket_name}/{object_name}	Управление HTTP-заголовками и метаданными объектов
COPY	/v1/{project_id}/{bucket_name}/{object_name}	Копирование объекта
DELETE	/v1/{project_id}/{bucket_name}/{object_name}	Удаление объекта

Получить объект

Выведет тело и заголовки объекта.

Пример запроса

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>'

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

В случае успеха запрос возвращает ответ с кодом 200.

Загрузить объект

Загружает объект в бакет. Такая загрузка используется для объектов размером до 100 МБ. Для объектов большего размера используйте сегментированную загрузку.

При использовании заголовка X-Copy-From можно загрузить в бакет скопированный объект. Объект копируется вместе с заголовком X-Delete-At независимо от того, куда был установлен заголовок (на объект или бакет).

Заголовки запроса

Заголовок	Описание
X-Delete-At	Время удаления объекта в формате Unix Timestamp
X-Delete-After	Срок хранения объекта (в секундах)
Etag	Идентификатор Etag
X-Object-Meta-<...>	Метаданные объекта, где <...> — пользовательский заголовок
X-Copy-From	Путь до объекта, который нужно скопировать

Пример запроса

Загрузка объекта:

curl -i -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Delete-After: 180' \
-d "<object-body>" \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>'

Укажите:

<object-body> — тело объекта;
<object_name> — имя, которое будет присвоено объекту.

Копирование объекта:

curl -i -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Copy-From: /<bucket_name_1>/<object_name_1>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name_2>/<object_name_2>'

Укажите:

<bucket_name_2> — бакет, в который скопируется объект;
<object_name_2> — имя, с которым скопируется объект;
<bucket_name_1> — бакет, в котором находится копируемый объект;
<object_name_1> — объект, который нужно скопировать.

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

При загрузке объекта в случае успеха запрос возвращает ответ с кодом 201.

HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html
Etag: b65ad34618e410d9d8bf624d61f8a980
Date: Thu, 15 Mar 2023 07:31:32 GMT

При копировании объекта в случае успеха запрос возвращает ответ с кодом 201.

HTTP/1.1 201
Created etag: 0f343b0931126a20f133d67c2b018a3b
X-Copied-From: bucket_name_1/object_name_1
X-Copied-From-Last-Modified: Mon, 27 May 2013 13:16:49 GMT
Last-Modified: Tue, 28 May 2018 06:30:51 GMT

Удалить несколько объектов

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

Пример запроса

Удаление объектов из разных бакетов:

curl -i -XPOST \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'Content-Type: text/plain' \
-d $'<bucket_name_1>/<object_name_1>\n<bucket_name_2>/<object_name_2>' \
'https://<swift_domain>/v1/<project_id>?bulk-delete=true&format=json'

Укажите:

<bucket_name_1>/<object_name_1> — путь до объекта в первом бакете;
<bucket_name_2>/<object_name_2> — путь до объекта во втором бакете;
\n — перенос строки, необходимо указывать между объектами.

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

В случае успеха запрос возвращает ответ с кодом 200.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Fri, 08 Jun 2018 13:37:53 GMT
Content-Length: 101
{'Number Not Found':0,'Response Status':'200 OK','Response Body':'','Errors':null,'Number Deleted':2}

Управлять HTTP-заголовками и метаданными объектов

Устанавливает значения для указанных в запросе пользовательских и HTTP-заголовков. Заголовки используются для управления кэшированием на стороне клиента и промежуточных прокси-серверах.

Поддерживаемые HTTP-заголовки:

Cache-Control
Content-Encoding
Content-Type
Content-Disposition
Link

Заголовки запроса

Заголовок	Описание
X-Container-Meta-<...>	Заголовок, параметры которого нужно установить. Укажите <...> — заголовок (например, X-Container-Meta-Cache-Control)

Пример запроса

Добавление заголовка Link к объекту:

curl -i -XPOST \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'Link: rel=canonical' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>'

Добавление пользовательского заголовка:

curl -i -XPOST \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Object-Meta-Some: metadata' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>'

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

Запрос на добавление заголовка Link в случае успеха возвращает ответ с кодом 202.

HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html

Запрос на добавление пользовательского заголовка в случае успеха возвращает ответ с кодом 201.

HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html
Etag: d41d8cd98f00b204e9800998ecf8427e

Копировать объект

Объект будет скопирован в другой бакет или по другому префиксу. Если для заголовка X-Fresh-Metadata установить значение true, то при копировании новый объект будет создан с новыми заголовками, в том числе без X-Delete-At.

Заголовки запроса

Заголовок	Описание
Destination	Путь, по которому будет скопирован объект

Пример запроса

curl -i -XCOPY \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'Destination: /<bucket_name_2>/<object_name_2>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name_1>/<object_name_1>'

Укажите:

<bucket_name_1> — бакет, в котором находится копируемый объект;
<object_name_1> — объект, который нужно скопировать.
<bucket_name_2> — бакет, в который скопируется объект;
<object_name_2> — имя, с которым скопируется объект.

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

В случае успеха запрос возвращает ответ с кодом 201.

HTTP/1.1 201
Created etag: 0f343b0931126a20f133d67c2b018a3b
X-Copied-From: bucket1/file
X-Copied-From-Last-Modified: Mon, 27 May 2013 13:16:49 GMT
Last-Modified: Tue, 28 May 2013 06:30:51 GMT

Удалить объект

Объект будет удален из бакета.

Для удаления сегментированного объекта используйте query-параметром ?multipart-manifest=delete — будут удалены сегменты объекта и манифест.

Пример запроса

curl -i -XDELETE \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>'

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

В случае успеха запрос возвращает ответ с кодом 204.

HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8

Заголовки для отложенного удаления

Заголовки указываются при отправке запросов PUT и POST и определяют, когда объект будет автоматически удален из хранилища.

Заголовок	Значение	Описание
X-Delete-At	Значение времени (timestamp) в формате Unix Epoch	Сервер будет хранить объект до времени, переданном в заголовке. Для конвертирования в человекочитаемый вид можно использовать EpochConverter.
X-Delete-After	Целочисленное количество секунд	Сервер преобразует это значение в заголовок X-Delete-At. Через указанное количество секунд запрос начнет возвращать ответ 404 на запрос к объекту, при этом объекты автоматически удаляются через некоторое время.

Если указаны оба заголовка, приоритетным будет заголовок X-Delete-After.

Особенности работы заголовков:

если объект загружается с помощью PUT-запроса и заголовком X-Delete-At, а у бакета модифицированный заголовок, заголовок объекта будет перезаписан на заголовок бакета;
если в бакете включено версионирование, заголовки X-Delete-At и X-Delete-After не переносятся на созданную версию. Загруженная версия удалена не будет, но объект пропадет из списка.

Сегментированные объекты

В хранилище нет ограничений на размер загружаемых объектов, но объекты размером более 100 МБ не рекомендуется помещать в хранилище целиком — нужно разбивать объект на сегменты, загружать каждый сегмент объекта и файл манифеста, объединяющий все сегменты объекта (технология DLO/SLO). Подробнее о загрузке сегментированных объектов в инструкции документации Загрузить объект.

При использовании сегментированной загрузки можно загружать два типа больших объектов:

динамические (DLO), при загрузке манифеста динамического объекта необходимо указать бакет и префикс сегментов. Вы можно загружать и удалять отдельные сегменты без необходимости менять файл манифеста;
статические (SLO), при загрузке манифеста статического объекта указывается путь до каждого сегмента, из которых состоит объект. При каждом изменении сегментов необходимо редактировать и загружать заново файл манифеста. Опционально для сегментов можно указать их контрольные суммы (Etag) и размер.

Чтобы получить файл манифеста, выполните GET-запрос на получение объекта с query-параметром ?multipart-manifest=get.

Удалить все сегменты и объект с манифестом можно с помощью DELETE-запроса с query-параметром ?multipart-manifest=delete.

Загрузить сегменты объекта

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

Пример запросов

curl -i -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-d "hello " \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>/00000001'

curl -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-d "world" \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>/00000002'

curl -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-d "!" \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>/00000003'

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

В случае успеха запросы возвращают ответы с кодом 201.

Загрузить манифест динамического объекта

Пример запроса

curl -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Object-Manifest: <bucket_name>/<object_name>/' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>'

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

В случае успеха запрос возвращает ответ с кодом 201.

Загрузить манифест статического объекта

Пример запроса

В теле манифеста статического объекта укажите путь до каждого сегмента объекта.

curl -XPUT \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Static-Large-Object: True' \
"[{"path": "/<bucket_name>/<object_name>/00000001"}, {"path": "/<bucket_name>/<object_name>/00000002"}, {"path": "/<bucket_name>/<object_name>/00000003"} ...]" \
'https://<swift_domain>/v1/<project_id>/<bucket_name>/<object_name>?multipart-manifest=put'

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

В случае успеха запрос возвращает ответ с кодом 201.

Лимиты

POST	/v1/{project_id}/{bucket_name}	Установка лимитов на бакет
POST	/v1/{project_id}	Установка лимитов на проект

Установить лимиты на бакет

Устанавливает на бакет ограничения, переданные в заголовках X-Container-Meta-Quota-Bytes и X-Container-Meta-Quota-Count.

Заголовки запроса

Заголовок	Описание
X-Container-Meta-Quota-Bytes	Максимальный объем хранения данных (в байтах)
X-Container-Meta-Quota-Count	Максимальное количество объектов в бакете
X-Container-Meta-Default-Delete-After	Срок хранения всех объектов в бакете (в секундах). По истечении этого срока объекты будут автоматически удалены

Пример запроса

curl -i -XPOST \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Container-Meta-Quota-Bytes: 52428800' \
-H 'X-Container-Meta-Quota-Count: 1000' \
-H 'X-Container-Meta-Default-Delete-After: 300' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>'

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

В случае удачного выполнения запроса будет возвращен ответ с кодом 202.

HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html

Установить лимиты на проект

Устанавливает на проект ограничение, переданное в заголовке X-Account-Meta-Quota-Bytes.

Заголовки запроса

Заголовок	Описание
X-Container-Meta-Quota-Bytes	Максимальный объем хранения данных (в байтах)

Пример запроса

curl -i -XPOST \
-H 'X-Auth-Token: <x_auth_token>' \
-H 'X-Account-Meta-Quota-Bytes: 52428800' \
'https://<swift_domain>/v1/<project_id>'

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

В случае удачного выполнения запроса будет возвращен ответ с кодом 202.

HTTP/1.1 202 Accepted
Content-Length: 76
Content-Type: text/html

Дополнительные query-параметры

В запросе на получение списка бакетов или объектов можно использовать дополнительные query-параметры.

format

Вернет список объектов в определенном формате.

Пример запроса:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>?format=json'

Список объектов будет возвращен в формате JSON.

limit

Задаст точное количество объектов, которые будут включены в список (например, при работе с бакетами, где хранится большое количество объектов).

Пример запроса:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>?limit=20'

В список будут включены первые 20 объектов.

marker

Задаст объект, начиная с которого будет выведен список.

Пример запроса:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>?marker=<object_name>'

В списке будут отображены объекты, которые следуют после объекта <object_name>.

prefix

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

Пример запроса:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>?prefix=my'

В списке будут отображены объекты, которые начинаются с символов my.

delimiter

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

Пример запроса:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>?delimiter=/'

Будут выведены файлы и части префиксов (псевдопапки) на верхнем уровне:

photos/
videos/
file.jpg

Здесь:

photos/, videos/ — части префиксов до символа /, которые есть у объектов в бакете;
file.jpg — файл без префикса (символа / в названии).

Параметр delimiter можно использовать совместно с параметром prefix, чтобы выводить список объектов и псевдопапок по указанному префиксу.

Пример запроса:

curl -i \
-H 'X-Auth-Token: <x_auth_token>' \
'https://<swift_domain>/v1/<project_id>/<bucket_name>?prefix=photos/&delimiter=/'

Пример вывода:

photos/animals/
photos/file.jpg

Символические ссылки

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

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

Создать символическую ссылку можно с помощью пустого PUT-запроса на загрузку объекта с заголовком X-Symlink-Target: <bucket_name>/<object_name>.

По умолчанию символические ссылки динамические — они ссылаются на объект по его имени. Символическую ссылку можно сделать статической: при переходе по ссылке дополнительно проверяется Etag объекта. Для этого добавьте в запрос заголовок X-Symlink-Target-Etag: <etag>.

Если объект с ссылкой будет не пустой, запрос вернет ответ 400.

Чтобы получить объект с символической ссылкой, выполните GET или HEAD-запрос с параметром ?symlink=get.