Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Object Storage
  • Справочник Terraform
    • Аутентификация в API
      • Как пользоваться API
      • Подписывание запросов
        • Все сервисы и методы
          • Общий порядок составной загрузки
          • startUpload
          • uploadPart
          • copyPart
          • listParts
          • abortUpload
          • completeUpload
          • listUploads
        • Общие заголовки запросов
        • Общие заголовки ответов
        • Ответы
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Логи бакета
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы

В этой статье:

  • Запрос
  • Path параметры
  • Query параметры
  • Заголовки
  • Ответ
  • Заголовки
  • Коды ответов
  1. Справочник API
  2. REST (совместимый с Amazon S3)
  3. REST
  4. Multipart upload
  5. uploadPart

Метод uploadPart

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

Сохраняет часть объекта.

Пользователь самостоятельно нумерует части объекта и передает номера Object Storage. Номер однозначно идентифицирует часть и определяет ее порядок в общей последовательности. Номер — это целое число в промежутке от 1 до 10000 включительно.

Если загружаются несколько частей с одинаковым номером, Object Storage сохраняет последнюю поступившую.

Размер каждой части, кроме последней, должен быть не менее 5MB.

Более подробную информацию читайте в разделе Общий порядок составной (multipart) загрузки.

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

ЗапросЗапрос

PUT /{bucket}/{key}?partNumber=PartNumber&uploadId=UploadId HTTP/2

Path параметрыPath параметры

Параметр Описание
bucket Имя бакета.
key Ключ объекта.

Query параметрыQuery параметры

Параметр Описание
partNumber Идентификатор, который вы присвоили загружаемой части.
uploadId Идентификатор составной загрузки, который Object Storage вернул при инициализации.

ЗаголовкиЗаголовки

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

Заголовок Content-Length обязателен.

Заголовок Content-MD5 обязателен, если в бакете настроены блокировки версий объектов по умолчанию.

ОтветОтвет

ЗаголовкиЗаголовки

Ответ может содержать общие заголовки и заголовки, перечисленные в таблице ниже.

Заголовок Описание
X-Amz-Storage-Class Класс хранилища объекта.
Имеет значение COLD, если объект находится в холодном хранилище, или ICE, если объект находится в ледяном хранилище.

Если объект сохранен в стандартном хранилище, то заголовка не будет.

Коды ответовКоды ответов

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

Дополнительно, Object Storage может вернуть ошибки, описанные в таблице ниже.

Ошибка Описание HTTP-код
NoSuchUpload Указанная загрузка не существует. Возможно указан неверный идентификатор загрузки или загрузка была завершена или удалена. 404 Not Found
EntityTooSmall Размер части слишком мал.

Загружаемая часть должна быть не менее 5MB.
400 Bad Request

См. такжеСм. также

  • Отладка запросов с помощью утилиты AWS CLI
  • Пример отправки подписанного запроса с помощью утилиты curl
  • Пример кода для генерации подписи

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

Предыдущая
startUpload
Следующая
copyPart
Проект Яндекса
© 2025 ООО «Яндекс.Облако»