Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex Object Storage
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Бакеты
      • Создание бакета
      • Удаление бакета
      • Ограничение максимального размера бакета
      • Открытие публичного доступа к бакету
      • Шифрование бакета
      • Управление жизненными циклами объектов
      • Управление конфигурацией CORS
      • Управление политикой доступа
      • Управление версионированием бакета
      • Редактирование ACL бакета
      • Включение механизма логированния
    • Объекты
      • Загрузка объекта
      • Получение информации об объекте
      • Скачивание объекта
      • Получение публичной ссылки на объект
      • Удаление объекта
      • Удаление всех объектов
      • Удаление частично загруженного объекта
      • Редактирование ACL объекта
    • Хостинг статических сайтов
      • Настройка хостинга
      • Поддержка собственного домена
      • Поддержка нескольких доменных имен
      • Настройка HTTPS
  • Практические руководства
    • Получение статистики запросов к объекту с использованием S3 Select
    • Получение cтатистики посещения сайта с использованием S3 Select
    • Формирование отчета по ресурсной детализации расходов с использованием S3 Select
    • Шифрование на стороне сервера
    • Интеграция L7-балансировщика с CDN и Object Storage
    • Сине-зеленое и канареечное развертывание версий сервиса
    • Анализ логов с использованием DataLens
    • Использование скриптов инициализации для настройки GeeseFS в Yandex Data Proc
  • Концепции
    • Обзор
    • Бакет
    • Объект
    • Версионирование бакета
    • Жизненные циклы объектов
    • CORS
    • Хостинг статических сайтов
    • Подписанные (pre-signed) URL
    • Составная (multipart) загрузка
    • Список управления доступом (ACL)
    • Политика доступа (Bucket Policy)
    • Загрузка файла через HTML-форму
    • Класс хранилища
    • Механизм логирования действий с бакетом
    • Резервное копирование
    • Протокол TLS
    • Язык запросов S3 Select
    • Квоты и лимиты
  • Инструменты
    • Все инструменты
    • Консольные клиенты
      • AWS CLI
      • S3cmd
    • Файловые браузеры
      • CyberDuck
      • WinSCP
    • SDK
      • AWS SDK для Java
      • Python SDK (boto)
      • AWS SDK для .NET
      • AWS SDK для C++
      • AWS SDK для PHP
      • AWS SDK для Go
    • FUSE
      • GeeseFS
      • s3fs
      • goofys
    • FTP
      • Docker-контейнер для (S)FTP(S)
  • Справочник API
    • REST (совместимый с Amazon S3)
      • Как пользоваться API
      • Подписывание запросов
      • REST
        • Все сервисы и методы
        • Bucket
          • Все методы
          • create
          • getBucketEncryption
          • getMeta
          • listObjects
          • listBuckets
          • deleteBucket
          • deleteBucketEncryption
          • putBucketEncryption
          • putBucketVersioning
          • getBucketVersioning
          • putBucketLogging
          • getBucketLogging
          • listObjectVersions
        • Object
          • Все методы
          • upload
          • get
          • copy
          • getObjectMeta
          • delete
          • deleteMultipleObjects
          • options
          • selectObjectContent
        • Multipart upload
          • Общий порядок составной загрузки
          • startUpload
          • uploadPart
          • copyPart
          • listParts
          • abortUpload
          • completeUpload
          • listUploads
        • Static Website Hosting
          • Все методы
          • upload
          • get
          • delete
          • Коды ответов статического сайта
        • CORS
          • Все методы
          • XML-структура конфигурации CORS
          • upload
          • get
          • delete
        • Lifecycles
          • Все методы
          • XML-структура конфигурации жизненных циклов
          • upload
          • get
          • delete
        • ACL
          • Все методы
          • XML-структура конфигурации ACL
          • objectGetAcl
          • objectPutAcl
          • bucketGetAcl
          • bucketPutAcl
        • Bucket Policy
          • Все методы
          • GetBucketPolicy
          • PutBucketPolicy
          • DeleteBucketPolicy
          • Схема данных
          • Действия
          • Условия
        • Общие заголовки запросов
        • Общие заголовки ответов
        • Ответы
    • gRPC и REST
      • Аутентификация в API
      • gRPC (англ.)
        • Overview
        • BucketService
        • OperationService
      • REST (англ.)
        • Overview
        • Bucket
          • Overview
          • create
          • delete
          • deleteHTTPSConfig
          • get
          • getHTTPSConfig
          • getStats
          • list
          • setHTTPSConfig
          • update
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • До 1 января 2019 года
      • С 1 января до 1 марта 2019 года
  • Вопросы и ответы
  1. Справочник API
  2. REST (совместимый с Amazon S3)
  3. REST
  4. Static Website Hosting
  5. upload

Метод upload

Статья создана
Yandex Cloud
  • Запрос
    • Path параметры
    • Query параметры
    • Заголовки
    • Схема данных
  • Ответ
    • Заголовки
    • Коды ответов

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

Запрос

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

Ответ

Заголовки

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

Коды ответов

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

Была ли статья полезна?

Language / Region
© 2022 ООО «Яндекс.Облако»
В этой статье:
  • Запрос
  • Path параметры
  • Query параметры
  • Заголовки
  • Схема данных
  • Ответ
  • Заголовки
  • Коды ответов