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