Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»

Object Storage API, REST совместимый с Amazon S3: PutBucketWebsite

Статья создана
Обновлена 24 июля 2026 г.
Открыть в Markdown

Загружает конфигурацию хостинга статического сайта для бакета.

Подробнее о подготовке к работе с API и общем виде запроса в разделе Как пользоваться S3 API.

Запрос

PUT /{bucket}?website HTTP/2

Path параметры

Параметр

Описание

bucket

Имя бакета

Query параметры

Параметр

Описание

website

Обязательный параметр для обозначения типа операции

Заголовки

Используйте в запросе необходимые общие заголовки.

Схема данных

Бакет можно сконфигурировать:

Пример конфигурации:

<!--Конфигурация для сайта-->
<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <IndexDocument>
        <Suffix>index.html</Suffix>
    </IndexDocument>
    <ErrorDocument>
        <Key>Error.html</Key>
    </ErrorDocument>
</WebsiteConfiguration>

Возможные элементы:

Элемент

Описание

WebsiteConfiguration

Заголовок верхнего уровня описания сайта.

IndexDocument/Suffix

Главная страница сайта.

Путь: /WebsiteConfiguration/IndexDocument/Suffix.

ErrorDocument/Key

Документ, который пользователь увидит при возникновении ошибок с кодом 4xx.

Путь: /WebsiteConfiguration/ErrorDocument/Key.

Пример конфигурации:

<!--Конфигурация для редиректа всех запросов-->
<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <RedirectAllRequestsTo>
        <HostName>example.com</HostName>
        <Protocol>http</Protocol>
    </RedirectAllRequestsTo>
</WebsiteConfiguration>

Возможные элементы:

Элемент

Описание

WebsiteConfiguration

Заголовок верхнего уровня описания сайта.

RedirectAllRequestsTo

Содержит конфигурацию переадресации всех запросов.

Путь: /WebsiteConfiguration/RedirectAllRequestsTo.

HostName

Хост, на который перенаравляются все запросы к бакету.

Путь: /WebsiteConfiguration/RedirectAllRequestsTo/HostName.

Protocol

Протокол, который используется при переадресации: http, https. Необязательный элемент.

Путь: /WebsiteConfiguration/RedirectAllRequestsTo/Protocol.

Пример конфигурации:

<!--Конфигурация для условного редиректа запросов-->
<WebsiteConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <IndexDocument>
        <Suffix>index.html</Suffix>
    </IndexDocument>
    <ErrorDocument>
        <Key>Error.html</Key>
    </ErrorDocument>
    <RoutingRules>
        <RoutingRule>
            <Condition>
                <KeyPrefixEquals>k8s/</KeyPrefixEquals>
            </Condition>
            <Redirect>
                <ReplaceKeyPrefixWith>kubernetes/</ReplaceKeyPrefixWith>
            </Redirect>
        </RoutingRule>
    </RoutingRules>
</WebsiteConfiguration>

Возможные элементы:

Элемент

Описание

WebsiteConfiguration

Заголовок верхнего уровня описания сайта.

IndexDocument/Suffix

Главная страница сайта.

ErrorDocument/Key

Документ, который пользователь увидит при возникновении ошибок с кодом 4xx.

RoutingRules

Контейнер правил маршрутизации RoutingRule.
Должен содержать хотя бы одно правило.

RoutingRule

Правило маршрутизации.
Определяет условия и переадресацию при выполнении условий.

Condition

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

KeyPrefixEquals

Условие задает префикс ключа объекта, с которого перенаправляются запросы.
KeyPrefixEquals обязателен, если HttpErrorCodeReturnedEquals не определен. Если KeyPrefixEquals и HttpErrorCodeReturnedEquals определены, условие выполняется при значении true обоих параметров.

HttpErrorCodeReturnedEquals

Условие задает код ошибки, при возникновении которой применяется переадресация.
HttpErrorCodeReturnedEquals обязателен, если KeyPrefixEquals не определен. Если KeyPrefixEquals и HttpErrorCodeReturnedEquals определены, условие выполняется при значении true обоих параметров.

Redirect

Контейнер переадресаций.
Запрос можно перенаправить на другую страницу, другой хост, а также изменить протокол.
Правило RoutingRule должно содержать хотя бы один элемент Redirect.
Переадресация должна содержать хотя бы один из элементов Protocol, HostName, ReplaceKeyPrefixWith, ReplaceKeyWith или HttpRedirectCode.

Protocol

Переадресация указывает в заголовке ответа Location, какой из протоколов http или https следует использовать.
Параметр необязателен, если применяются другие переадресации.

HostName

Переадресация указывает в заголовке ответа Location имя хоста, которое следует использовать.
Параметр необязателен, если применяются другие переадресации.

ReplaceKeyPrefixWith

Переадресация указывает префикс ключа объекта, заменяющий значение KeyPrefixEquals в запросе перенаправления.
Несовместим с параметром ReplaceKeyWith.
Параметр необязателен, если применяются другие переадресации.

ReplaceKeyWith

Переадресация указывает ключ объекта, который будет использоваться в заголовке Location.
Несовместим с параметром ReplaceKeyPrefixWith.
Параметр необязателен, если применяются другие переадресации.

HttpRedirectCode

Переадресация указывает HTTP-код перенаправления в заголовке ответа Location.
Возможные значения: любой код 3xx.
Параметр необязателен, если применяются другие переадресации.

Ответ

Заголовки

Ответ может содержать только общие заголовки.

Коды ответов

Перечень возможных ответов смотрите в разделе Ответы.

Настроить хостинг

Полезные ссылки

Предыдущая
Все методы
Следующая
GetBucketWebsite