Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • ML Services
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Object Storage
    • Все инструкции
      • Загрузка объекта
      • Составная загрузка объекта
      • Получение списка объектов в бакете
      • Получение информации об объекте
      • Скачивание объекта
      • Восстановление версии объекта
      • Переименование и перемещение объекта
      • Копирование объектов
      • Получение подписанной ссылки (pre-signed URL) на скачивание объекта
      • Настройка блокировок версии объекта
      • Удаление объекта
      • Удаление всех объектов
      • Удаление частично загруженного объекта
      • Редактирование ACL объекта
      • Управление метками объекта
      • Управление пользовательскими метаданными объекта
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Логи бакета
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы

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

  • Переименование
  • Изменение префикса для группы объектов
  • Перемещение
  • Перемещение объекта из одной папки в другую
  • Перемещение папки с объектами
  • Перемещение всех объектов из одного бакета в другой
  1. Пошаговые инструкции
  2. Объекты
  3. Переименование и перемещение объекта

Переименование и перемещение объекта

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 10 сентября 2025 г.
  • Переименование
    • Изменение префикса для группы объектов
  • Перемещение
    • Перемещение объекта из одной папки в другую
    • Перемещение папки с объектами
    • Перемещение всех объектов из одного бакета в другой

Чтобы работать с объектами в зашифрованном бакете, у пользователя или сервисного аккаунта вместе с ролью storage.configurer должны быть следующие роли на ключ шифрования:

  • kms.keys.encrypter — для чтения ключа, шифрования и загрузки объектов;
  • kms.keys.decrypter — для чтения ключа, расшифровки и скачивания объектов;
  • kms.keys.encrypterDecrypter — включает разрешения, предоставляемые ролями kms.keys.encrypter и kms.keys.decrypter.

Подробнее см. Сервисные роли Key Management Service.

Помимо Yandex Cloud CLI и AWS CLI для переименования и перемещения объектов вы можете воспользоваться поддерживаемыми инструментами, например файловым браузером.

ПереименованиеПереименование

Примечание

Можно переименовать объекты в бакете. Переименовать сам бакет нельзя. Но вы можете создать новый бакет и скопировать в него все объекты из исходного.

Yandex Cloud CLI
AWS CLI

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

  1. Посмотрите описание команды CLI для переименования объекта в бакете:

    yc storage s3 mv --help
    
  2. Получите список бакетов в каталоге по умолчанию:

    yc storage bucket list
    

    Результат:

    +------------------+----------------------+-------------+-----------------------+---------------------+
    |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
    +------------------+----------------------+-------------+-----------------------+---------------------+
    | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
    +------------------+----------------------+-------------+-----------------------+---------------------+
    
  3. Выполните команду:

    yc storage s3 mv \
      s3://<имя_бакета>/<ключ_объекта> \
      s3://<имя_бакета>/<новый_ключ_объекта>
    

    Результат:

    move: s3://my-bucket/object.txt to s3://my-bucket/renamed-object.txt
    

Подробнее о команде yc storage s3 mv см. в документации.

  1. Если у вас еще нет AWS CLI, установите и сконфигурируйте его.

  2. Чтобы переименовать объект, выполните команду:

    aws --endpoint-url=https://storage.yandexcloud.net/ \
      s3 mv s3://<имя_бакета>/<ключ_объекта> s3://<имя_бакета>/<новый_ключ_объекта>
    

    Где:

    • --endpoint-url — эндпоинт Object Storage.
    • s3 mv — команда для переименования или перемещения объекта. Чтобы переименовать объект, в первой части команды укажите имя бакета и актуальный ключ объекта, который нужно переименовать, а во второй — имя бакета и новый ключ объекта.

    Результат:

    move: s3://<имя_бакета>/<ключ_объекта> to s3://<имя_бакета>/<новый_ключ_объекта>
    

Подробнее о команде aws s3 mv см. в документации AWS CLI Command Reference.

Изменение префикса для группы объектовИзменение префикса для группы объектов

Yandex Cloud CLI
AWS CLI

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы изменить префикс для группы объектов, выполните команду:

yc storage s3 mv --recursive \
  s3://<имя_бакета>/<префикс>/ \
  s3://<имя_бакета>/<новый_префикс>/

Результат:

move: s3://my-bucket/my-prefix/ to s3://my-bucket/renamed-prefix/

Подробнее о команде yc storage s3 mv см. в документации.

  1. Если у вас еще нет AWS CLI, установите и сконфигурируйте его.

  2. Выполните команду:

    aws --endpoint-url=https://storage.yandexcloud.net/ \
      s3 mv --recursive s3://<имя_бакета>/<префикс>/ s3://<имя_бакета>/<новый_префикс>/
    

    Где:

    • --endpoint-url — эндпоинт Object Storage.
    • s3 mv — команда для переименования или перемещения объекта. Чтобы переименовать объект, в первой части команды укажите имя бакета и актуальный префикс группы объектов, которую нужно переименовать, а во второй — имя бакета и новый префикс группы объектов.
    • --recursive — параметр для изменения префикса группы объектов.

    Результат:

    move: s3://<имя_бакета>/<префикс>/ to s3://<имя_бакета>/<новый_префикс>/
    

Подробнее о команде aws s3 mv см. в документации AWS CLI Command Reference.

ПеремещениеПеремещение

Yandex Cloud CLI
AWS CLI

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

  1. Посмотрите описание команды CLI для перемещения объекта:

    yc storage s3 mv --help
    
  2. Получите список бакетов в каталоге по умолчанию:

    yc storage bucket list
    

    Результат:

    +------------------+----------------------+-------------+-----------------------+---------------------+
    |       NAME       |      FOLDER ID       |  MAX SIZE   | DEFAULT STORAGE CLASS |     CREATED AT      |
    +------------------+----------------------+-------------+-----------------------+---------------------+
    | first-bucket     | b1gmit33ngp6******** | 53687091200 | STANDARD              | 2022-12-16 13:58:18 |
    +------------------+----------------------+-------------+-----------------------+---------------------+
    
  3. Выполните команду:

    yc storage s3 mv \
      s3://<имя_бакета-источника>/<ключ_объекта> \
      s3://<имя_целевого_бакета>/<ключ_объекта>
    

    Результат:

    move: s3://my-bucket/object.txt to s3://new-bucket/object.txt
    
  1. Если у вас еще нет AWS CLI, установите и сконфигурируйте его.

  2. Чтобы переместить объект, например, из одного бакета в другой, выполните команду:

    aws --endpoint-url=https://storage.yandexcloud.net/ \
      s3 mv s3://<имя_бакета-источника>/<ключ_объекта> s3://<имя_целевого_бакета>/<ключ_объекта>
    

    Где:

    • --endpoint-url — эндпоинт Object Storage.
    • s3 mv — команда для переименования или перемещения объекта. Чтобы переместить объект, в первой части команды укажите имя бакета-источника и ключ объекта, который нужно переместить, а во второй — имя целевого бакета и ключ объекта.

    Результат:

    move: s3://<имя_бакета-источника>/<ключ_объекта> to s3://<имя_целевого_бакета>/<ключ_объекта>
    

Подробнее о команде aws s3 mv см. в документации AWS CLI Command Reference.

Перемещение объекта из одной папки в другуюПеремещение объекта из одной папки в другую

В Object Storage папки имитируются с помощью префиксов ключей. Чтобы переместить объект из одной папки в другую, переименуйте префикс его ключа, например:

Yandex Cloud CLI
AWS CLI
yc storage s3 mv \
  s3://<имя_бакета>/<префикс>/<имя_объекта> \
  s3://<имя_бакета>/<новый_префикс>/<имя_объекта>

Результат:

move: s3://my-bucket/my-prefix/object.txt to s3://my-bucket/renamed-prefix/object.txt
aws --endpoint-url=https://storage.yandexcloud.net/ \
  s3 mv s3://<имя_бакета>/<префикс>/<имя_объекта> s3://<имя_бакета>/<новый_префикс>/<имя_объекта>

Результат:

move: s3://my-bucket/my-prefix/object.txt to s3://my-bucket/renamed-prefix/object.txt

Перемещение папки с объектамиПеремещение папки с объектами

В Object Storage папки имитируются с помощью префиксов ключей. Чтобы переместить папку с объектами, измените префикс для группы объектов.

Перемещение всех объектов из одного бакета в другойПеремещение всех объектов из одного бакета в другой

Yandex Cloud CLI
AWS CLI

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Выполните команду:

yc storage s3 mv --recursive \
  s3://<имя_бакета-источника>/ \
  s3://<имя_целевого_бакета>/

Результат:

move: s3://my-bucket/object1.txt to s3://new-bucket/object1.txt
move: s3://my-bucket/object2.txt to s3://new-bucket/object2.txt
  1. Если у вас еще нет AWS CLI, установите и сконфигурируйте его.

  2. Выполните команду:

    aws --endpoint-url=https://storage.yandexcloud.net/ \
      s3 mv --recursive s3://<имя_бакета-источника> s3://<имя_целевого_бакета>
    

    Где:

    • --endpoint-url — эндпоинт Object Storage.
    • s3 mv — команда для переименования или перемещения объекта. Чтобы переместить все объекты, в первой части команды укажите имя бакета-источника, а во второй — имя целевого бакета.
    • --recursive — параметр для перемещения всех объектов из одного бакета в другой.

    Результат:

    move: s3://<имя_бакета-источника>/<ключ_объекта_1> to s3://<имя_целевого_бакета>/<ключ_объекта_1>
    move: s3://<имя_бакета-источника>/<ключ_объекта_2> to s3://<имя_целевого_бакета>/<ключ_объекта_2>
    

Подробнее о команде aws s3 mv см. в документации AWS CLI Command Reference.

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

Предыдущая
Восстановление версии объекта
Следующая
Копирование объектов
Проект Яндекса
© 2025 ООО «Яндекс.Облако»