Связаться с намиПодключиться

Метод upload

Статья создана
Обновлена 15 августа 2025 г.

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

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

Запрос

PUT /{bucket}?website HTTP/2

Path параметры

Параметр Описание
bucket Имя бакета.

Query параметры

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

Заголовки

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

Схема данных

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

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

<!--Конфигурация для сайта-->
<ListBucketResult
          xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
          <KeyCount>1</KeyCount>
          <Name>my-sample-bucket</Name>
          <Prefix></Prefix>
          <MaxKeys>1000</MaxKeys>
          <IsTruncated>false</IsTruncated>
          <Contents>
              <Key>text.txt</Key>
              <LastModified>2025-05-15T07:23:08.030Z</LastModified>
              <Owner>
                  <ID>ajegtlf2q28a********</ID>
                  <DisplayName>ajegtlf2q28a********</DisplayName>
              </Owner>
              <ETag>&#34;f75a361db63aa4722fb8e083********&#34;</ETag>
              <Size>103</Size>
              <StorageClass>STANDARD</StorageClass>
              <TagSet></TagSet>
          </Contents>
      </ListBucketResult>

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

Элемент Описание
WebsiteConfiguration Заголовок верхнего уровня описания сайта.
IndexDocument/Suffix Главная страница сайта.

Путь: /WebsiteConfiguration/IndexDocument/Suffix.
ErrorDocument/Key Документ, который пользователь увидит при возникновении ошибок с кодом 4xx.

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

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

<!--Конфигурация для редиректа всех запросов-->
<ListBucketResult
          xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
          <KeyCount>1</KeyCount>
          <Name>my-sample-bucket</Name>
          <Prefix></Prefix>
          <MaxKeys>1000</MaxKeys>
          <IsTruncated>false</IsTruncated>
          <Contents>
              <Key>text.txt</Key>
              <LastModified>2025-05-15T07:23:08.030Z</LastModified>
              <Owner>
                  <ID>ajegtlf2q28a********</ID>
                  <DisplayName>ajegtlf2q28a********</DisplayName>
              </Owner>
              <ETag>&#34;f75a361db63aa4722fb8e083********&#34;</ETag>
              <Size>103</Size>
              <StorageClass>STANDARD</StorageClass>
              <TagSet></TagSet>
          </Contents>
      </ListBucketResult>

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

Элемент Описание
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.
Параметр необязателен, если применяются другие переадресации.

Ответ

Заголовки

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

Коды ответов

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

См. также

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