Bucket

У операций с бакетами есть типовые и специальные сообщения об ошибках, заголовки запросов и заголовки ответов, если они специальные, то это будет написано в описании операции.

Список операций с бакетами:

• Create — создать бакет.
• ListBuckets — получить список бакетов.
• HeadBucket — проверка наличия бакета и доступа к нему.
• ListObjects — получить список объектов бакета.
• DeleteBucket — удалить бакет.

С помощью операция PUT создается новый бакет. Чтобы создать бакет, нужно пройти регистрацию на платформе LinxCloud и получить ключ доступа для авторизации запросов. Нельзя создать бакет при помощи анонимного запроса. Инициатор запроса создания бакета по умолчанию становится его владельцем.

Создавая бакет, можно выбрать проекты или группы, которым нужно предоставить определенные права на бакет, и указать класс хранения (hotbox или icebox). Способы предоставления прав при помощи заголовков запроса:

• Указание готового ACL в запросе с помощью заголовка x-amz-acl в запросе.
• Указание явным образом права доступа с помощью заголовков `x-amz-grant-read`, `x-amz-grant-write`, `x-amz-grant-read-acp`, `x-amz-grant-write-acp`, `x-amz-grant-full-control` в запросе.

Нельзя использовать оба способа одновременно.

Запрос:

При помощи операции GET можно вернуть список существующих бакетов в проекте.

Запрос:

Воспользовавшись операцией GET, можно вернуть некоторые или все (до 1000) объекты в бакете. Можно использовать параметры запроса, как критериев выборки, чтобы отфильтровать объекты в бакете.

Требуется обладать правами на чтение бакета (READ), чтобы выполнить операцию.

Запрос:

С помощью этой операции можно определить существование бакета и наличие разрешения доступа к нему. Если бакет существует с разрешением доступа к нему, то операция возвращает HTTP статус 200. А если нет, то операция возвращается HTTP ошибку 404 или 403.

Запрос:

С помощью операции DELETE можно удалить бакет, который указан в запросе. Успех выполнения операции будет обозначен HTTP статусом 204.

Удаление невозможно, если получен HTTP статус 409, т.к. в бакете есть объекты. Нужно удалить все объекты из бакета и повторить операцию.

Запрос: