Метод upload
Статья создана
Загружает конфигурацию хостинга статического сайта для бакета.
Запрос
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.Параметр необязателен, если применяются другие переадресации. |
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.