Загрузка объекта

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

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

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

   Где:

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

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

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

   Где:

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

Команда aws s3 cp — высокоуровневая, ее функциональность ограничена. Подробнее см. в справочнике AWS CLI. Все возможности загрузки, которые поддерживаются в Object Storage, можно использовать при выполнении команды aws s3api put-object (см. ниже примеры работы с блокировками).

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Перед началом работы получите статические ключи доступа — секретный ключ и идентификатор ключа, используемые для аутентификации в Object Storage.

Чтобы создать объект в существующем бакете:

1. Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать.

   resource "yandex_iam_service_account" "sa" {
     name = "<имя_сервисного_аккаунта>"
   }
   
   // Назначение роли сервисному аккаунту
   resource "yandex_resourcemanager_folder_iam_member" "sa-admin" {
     folder_id = "<идентификатор_каталога>"
     role      = "storage.admin"
     member    = "serviceAccount:${yandex_iam_service_account.sa.id}"
   }
   
   // Создание статического ключа доступа
   resource "yandex_iam_service_account_static_access_key" "sa-static-key" {
     service_account_id = yandex_iam_service_account.sa.id
     description        = "static access key for object storage"
   }
   
   resource "yandex_storage_object" "test-object" {
     access_key = yandex_iam_service_account_static_access_key.sa-static-key.access_key
     secret_key = yandex_iam_service_account_static_access_key.sa-static-key.secret_key
     bucket     = "<имя_бакета>"
     key        = "<имя_объекта>"
     source     = "<путь_к_файлу>"
   }
   

   Где:

   • access_key — идентификатор статического ключа доступа.

   • secret_key — значение секретного ключа доступа.

   • bucket — имя бакета для добавления объекта. Обязательный параметр.

   • key — имя объекта в бакете. Обязательный параметр. Формат имени:

     • длина — от 3 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • source — относительный или абсолютный путь к файлу, который нужно загрузить в бакет.

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.

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

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

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

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

   aws --endpoint-url=https://storage.yandexcloud.net/ \
     s3api put-object \
     --body <путь_к_локальному_файлу> \
     --bucket <имя_бакета> \
     --key <ключ_объекта> \
     --object-lock-mode <тип_временной_блокировки> \
     --object-lock-retain-until-date <дата_и_время_окончания_временной_блокировки> \
     --object-lock-legal-hold-status <статус_бессрочной_блокировки>
   

   Где:

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

     • --body — путь к файлу, который нужно загрузить в бакет.

     • --bucket — имя вашего бакета.

     • --key — ключ, по которому объект будет храниться в бакете.

     • --object-lock-mode — тип временной блокировки:

       • GOVERNANCE — временная управляемая блокировка.
       • COMPLIANCE — временная строгая блокировка.

     • --object-lock-retain-until-date — дата и время окончания временной блокировки в любом из форматов, описанных в стандарте HTTP. Например, Mon, 12 Dec 2022 09:00:00 GMT. Указывается только вместе с параметром --object-lock-mode.

     • --object-lock-legal-hold-status — статус бессрочной блокировки:

       • ON — блокировка установлена.
       • OFF — блокировка не установлена.

   Вы можете установить на версию объекта только временную блокировку (параметры object-lock-mode и object-lock-retain-until-date), только бессрочную блокировку (object-lock-legal-hold-status) или обе сразу. Подробнее об их совместной работе см. в разделе Типы блокировок.

Чтобы загрузить версию объекта с блокировкой, воспользуйтесь методом S3 API upload с заголовками X-Amz-Object-Lock-Mode и X-Amz-Object-Lock-Retain-Until-Date для временной блокировки и X-Amz-Object-Lock-Legal-Hold для бессрочной.

Чтобы загрузить версию объекта с временной блокировкой по умолчанию, воспользуйтесь методом S3 API upload с заголовком Content-MD5.