Yandex Cloud
Поиск
Связаться с намиПопробовать бесплатно
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
  • Marketplace
    • Доступны в регионе
    • Инфраструктура и сеть
    • Платформа данных
    • Искусственный интеллект
    • Безопасность
    • Инструменты DevOps
    • Бессерверные вычисления
    • Управление ресурсами
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Партнёрская программа
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Акции и free tier
  • Истории успеха
  • Документация
  • Блог
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Интерфейс командной строки
  • Начало работы с CLI
    • Overview
    • help
    • init
      • Overview
        • Overview
        • abort-multipart-upload
        • complete-multipart-upload
        • copy-object
        • create-multipart-upload
        • delete-object
        • delete-object-tagging
        • delete-objects
        • get-bucket-acl
        • get-object
        • get-object-acl
        • get-object-legal-hold
        • get-object-retention
        • get-object-tagging
        • head-object
        • list-multipart-uploads
        • list-objects
        • list-parts
        • put-bucket-acl
        • put-object
        • put-object-acl
        • put-object-legal-hold
        • put-object-retention
        • put-object-tagging
        • upload-part
        • upload-part-copy
    • version
  • Релизы CLI
  • Решение проблем
  1. Справочник CLI (англ.)
  2. storage
  3. s3api
  4. put-object

yc storage s3api put-object

Статья создана
Yandex Cloud
Обновлена 27 января 2026 г.

Puts an object and its metadata to Object Storage

Command UsageCommand Usage

Syntax:

yc storage s3api put-object [Flags...] [Global Flags...]

FlagsFlags

Flag

Description

--bucket

string

[REQUIRED] Bucket name

--key

string

[REQUIRED] Object key

--acl

string

Sets a predefined ACL for an object.

--body

string

Object data.

--cache-control

string

Directives for caching data according to RFC 2616.

--content-disposition

string

Name Object Storage will suggest for the object to save it as a file when downloaded. Compliant with RFC 2616.

--content-encoding

string

Defines the content encoding according to RFC 2616.

--content-md5

string

128-bit MD5 hash value of the request body, base64 encoded.

--content-type

string

Data type in a request.

--expires

timestamp

Response expiration date.

--grant-full-control

string

Grants the access grantee the following permissions: READ, WRITE, READ_ACP, and WRITE_ACP for an object.

--grant-read

string

Grants the access grantee object read permission.

--grant-read-acp

string

Grants the access grantee object ACL read permission.

--grant-write-acp

string

Grants the access grantee object ACL write permission.

--metadata

key=value[,key=value...]

User-defined metadata.

--storage-class

string

Object storage class.

--server-side-encryption

string

The encryption algorithm of an uploaded object. Possible values: aws:kms.

--ssekms-key-id

string

The ID of the KMS key for encrypting an uploaded object.

--object-lock-mode

string

Type of retention put on the object (if the bucket is versioned and object lock is enabled in it). Possible values: GOVERNANCE and COMPLIANCE

--object-lock-retain-until-date

timestamp

Date and time until which the object is retained.

--object-lock-legal-hold-status

string

Type of legal hold put on the object.

Global FlagsGlobal Flags

Flag

Description

--profile

string

Set the custom configuration file.

--debug

Debug logging.

--debug-grpc

Debug gRPC logging. Very verbose, used for debugging connection problems.

--no-user-output

Disable printing user intended output to stderr.

--retry

int

Enable gRPC retries. By default, retries are enabled with maximum 5 attempts.
Pass 0 to disable retries. Pass any negative value for infinite retries.
Even infinite retries are capped with 2 minutes timeout.

--cloud-id

string

Set the ID of the cloud to use.

--folder-id

string

Set the ID of the folder to use.

--folder-name

string

Set the name of the folder to use (will be resolved to id).

--endpoint

string

Set the Cloud API endpoint (host:port).

--token

string

Set the OAuth token to use.

--impersonate-service-account-id

string

Set the ID of the service account to impersonate.

--no-browser

Disable opening browser for authentication.

--format

string

Set the output format: text (default), yaml, json, json-rest.

--jq

string

Query to select values from the response using jq syntax

-h, --help

Display help for the command.

  • Удалить объект или версию объекта без блокировки
  • Загрузить объект с метаданными
  • Простая загрузка

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

Предыдущая
put-bucket-acl
Следующая
put-object-acl
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»