Наряду со стандартными заголовками, система поддерживает параметры, специфичные для данной операции, перечисленные ниже.
Подробную информацию об операции и примеры см. в документации AWS: CreateBucket
Предыдущее название операции: PUT Bucket
Заголовки запроса (Request Headers)
- x-amz-acl
- x-amz-object-lock-enabled
Примечание. Дополнительную информацию о поддержке функции «Блокировка объектов» в S3 см. в Обзор функции WORM (блокировка объектов).
- x-amz-grant-read
- x-amz-grant-write
- x-amz-grant-read-acp
- x-amz-grant-write-acp
- x-amz-grant-full-control
Дополнения к S3 API
Система поддерживает следующий заголовок запроса в качестве расширения для операции "PUT Bucket":| Имя | Описание | Обязательно |
|---|---|---|
| x-gmt-policyid |
Этот заголовок указывает уникальный идентификатор политики хранения, которая будет назначена вновь созданному сегменту. Политика хранения определяет, как данные в сегменте будут распределяться и защищаться либо путем репликации, либо путем кодирования с удалением. Системные администраторы могут создавать несколько политик хранения через CMC, и система автоматически присваивает каждой из них уникальный идентификатор политики, который становится частью определения политики. (Чтобы получить список политик хранения для вашей системы и их идентификаторы, вы можете использовать метод GET /bppolicy/listpolicy в API администратора). С помощью заголовка запроса "x-gmt-policyid" для "PUT Bucket" вы указываете идентификатор желаемой политики хранения при создании нового сегмента. Однако следует отметить, что некоторые политики могут быть недоступны для всех групп пользователей — доступность политики определяется системными администраторами во время ее создания, и эта информация становится частью определения политики. При указании значения "x-gmt-policyid" в запросе "PUT Bucket" идентификатор политики должен соответствовать политике, доступной для группы, к которой принадлежит владелец сегмента. Кроме того, идентификатор политики должен соответствовать политике хранения из региона обслуживания, указанного в элементе LocationConstraint запроса "PUT Bucket". Если запрос "PUT Bucket" не содержит заголовок запроса "x-gmt-policyid", система автоматически назначит сегменту политику хранения по умолчанию во время его создания. Примечание. После создания бакета ему нельзя назначить другую политику хранения. Политика хранения, назначенная при создании, будет действовать на протяжении всего срока службы бакета. ВНИМАНИЕ. Ошибка 403 возвращается, если вы указываете идентификатор политики, который не существует, отключен, недоступен для региона, в котором создается корзина, или недоступен для группы, к которой принадлежит владелец бакета. Ошибка 403 также возвращается, если вы не указываете заголовок "x-gmt-policyid", и в системе еще нет установленной политики хранения по умолчанию.Пример заголовка: x-gmt-policyid: 1bc90238f9f11cb32f5e4e901675d50b |
Нет |
Элементы запроса (Request Elements)
- CreateBucketConfiguration
- LocationConstraint
ВАЖНО: Применяются те же ограничения на именование корзин, что и Amazon S3.
Кроме того, если вы используете нижнее подчеркивание в имени бакета, вы не сможете включить автоматическое распределение по уровням хранения для этого бакета (для переноса объектов в Amazon или другие удаленные хранилища по настраиваемому расписанию).
Лучше не использовать нижнее подчеркивание при именовании новых бакетов, на случай, если вам потребуется включить автоматическое распределение по уровням хранения для бакета сразу или в будущем.
см. также:
к S3 API
