Управление объектами в бакете

1. Установите и настройте AWS CLI, если он еще не установлен.

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

    
   aws s3 ls s3://<ИМЯ_БАКЕТА>/<ПУТЬ>/ --recursive --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <ИМЯ_БАКЕТА> — имя целевого бакета.

   • <ПУТЬ> — путь до директории. Укажите путь, чтобы вывести список объектов, расположенных в определенной директории. Пример: если у вас есть доступ только к объектам, расположенным в определенной директории.

   • --recursive — параметр, при использовании которого команда выполнится для всех объектов, расположенных в бакете или в указанной директории.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое используется в вашей инсталляции VK Object Storage. Формат имени может отличаться. Чтобы узнать точный формат ссылки обратитесь к вашему администратору.

Описание доступных параметров для команды просмотра списка объектов — в официальной документации AWS CLI.

1. Установите и настройте SDK для Go, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   package mainimport (    "github.com/aws/aws-sdk-go/aws"    "github.com/aws/aws-sdk-go/aws/session"    "github.com/aws/aws-sdk-go/service/s3"    "log")const vkCloudHotboxEndpoint = "https://hb.ru-msk.vkcloud-storage.ru"const defaultRegion = "ru-msk"func main() {    // Создание сессии    sess, _ := session.NewSession()    // Подключение к сервису VK Object Storage    svc := s3.New(sess, aws.NewConfig().WithEndpoint(vkCloudHotboxEndpoint).WithRegion(defaultRegion))    bucket := "gobucket"    // получение списка объектов в бакете    result, err := svc.ListObjectsV2(&s3.ListObjectsV2Input{ 	   Bucket: aws.String(bucket),    })    if err != nil { 	   log.Fatalf("Unable to list items in bucket %q, %v", bucket, err)    } else {      // итерирование по объектам 	   for _, item := range result.Contents { 		log.Printf("Object: %s, size: %d\n", aws.StringValue(item.Key), aws.Int64Value(item.Size)) 	   }    }}

   Команда ListObjectsV2 подробно описана в официальной документации к библиотеке aws-sdk-go.

1. Установите и настройте SDK для Python, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   import boto3session = boto3.session.Session()s3_client = session.client(service_name='s3',endpoint_url='https://hb.ru-msk.vkcloud-storage.ru')test_bucket_name = 'boto3-test-bucket-name'for key in s3_client.list_objects(Bucket=test_bucket_name) ['Contents']:print(key['Key'])

   Команда list_object подробно описана в официальной документации к библиотеке boto3.

На левой панели вашего файлового менеджера откройте папку в вашей операционной системе, в которую вы планируете загрузить файл. На правой панели файлового менеджера откройте VK Object Storage и перейдите в нужный бакет.

На правой панели файлового менеджера найдите файл, который вы планируете скачать из бакета и с помощью мыши перетащите его на левую панель. Таким образом вы загрузите копию файла из бакета.

Или используйте кнопки в правой панели файлового менеджера Copy или Move. Для этого выделите нужный файл или группу файлов и нажмите соответсвующую кнопку. Функция «Copy» загружает копию файла из бакета, функция «Move» перемещает файл из бакета. Исходный файл в бакете удалится.

1. Установите и настройте AWS CLI, если он еще не установлен.

2. Откройте консоль и перейдите в директорию, в которую нужно скачать объект.

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

    
   aws s3api get-object \  --bucket <ИМЯ_БАКЕТА> \  --key <КЛЮЧ_ОБЪЕКТА> \  <ИМЯ_ФАЙЛА> \  --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <ИМЯ_БАКЕТА> — имя бакета, в котором находится нужный объект.

   • <КЛЮЧ_ОБЪЕКТА> — имя объекта и путь до него, включая директории, если они есть.

   • <ИМЯ_ФАЙЛА> — имя, которое будет присвоено скачанному файлу.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое было указано при установке сервиса.

   Пример команды скачивания объекта

1. Установите и настройте SDK для Go, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   package mainimport (    "github.com/aws/aws-sdk-go/aws"    "github.com/aws/aws-sdk-go/aws/session"    "github.com/aws/aws-sdk-go/service/s3"    "log"    "strings")const (    vkCloudHotboxEndpoint = "https://hb.ru-msk.vkcloud-storage.ru"    defaultRegion         = "ru-msk")func main() {    // Создание сессии    sess, _ := session.NewSession()    // Подключение к сервису VK Object Storage    svc := s3.New(sess, aws.NewConfig().WithEndpoint(vkCloudHotboxEndpoint).WithRegion(defaultRegion))    bucket := "gobucket"    key := "test_string.txt"    // Извлечение объекта из бакета    if result, err := svc.GetObject(&s3.GetObjectInput{ 	   Bucket: aws.String(bucket), 	   Key:    aws.String(key),    }); err != nil { 	   log.Fatalf("Unable to get object %q from bucket %q, %v\n", key, bucket, err)    } else { 	   data := make([]byte, *result.ContentLength) 	   result.Body.Read(data) 	   log.Printf("File with data %q downloaded from bucket %q", data, bucket)    }}

   Команда GetObject подробно описана в официальной документации к библиотеке aws-sdk-go.

1. Установите и настройте SDK для Python, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   import boto3session = boto3.session.Session()s3_client = session.client(service_name='s3', endpoint_url='https://hb.ru-msk.vkcloud-storage.ru')response = s3_client.get_object(Bucket='boto3-bucket-name-test', Key='object_name.txt')print(response)print(response['Body'].read())

   Команда get_object подробно описана в официальной документации к библиотеке boto3.

1. Установите и настройте AWS CLI, если он еще не установлен.

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

   К одному объекту

   Ко всем объектам в бакете или в его директории

    
   aws s3api put-object-acl \   --acl <НАСТРОЙКА_ACL> \   --bucket <ИМЯ_БАКЕТА> \   --key <КЛЮЧ_ОБЪЕКТА> \   --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <НАСТРОЙКА_ACL> — уровень доступа ACL. Если указанный уровень доступа не настроен в проекте, то объекту будет присвоен уровень доступа private.

   • <ИМЯ_БАКЕТА> — имя бакета, в котором находится нужный объект.

   • <КЛЮЧ_ОБЪЕКТА> — полное имя объекта, включая путь до него.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое используется в вашей инсталляции VK Object Storage. Формат имени может отличаться. Чтобы узнать точный формат ссылки обратитесь к вашему администратору.

   Пример команды настройки доступа к объекту

   Полное описание операции изменения ACL объекта доступно в официальной документации AWS CLI.

    
   aws s3 cp s3://<ИМЯ_БАКЕТА>/<ПУТЬ>  s3://<ИМЯ_БАКЕТА>/<ПУТЬ> \   --acl <НАСТРОЙКА_ACL> \   --recursive \   --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <ИМЯ_БАКЕТА> — имя бакета, доступ к объектам в котором нужно изменить.

   • <ПУТЬ> — путь до директории, доступ к объектам в которой нужно изменить.

   • <НАСТРОЙКА_ACL> — уровень доступа ACL. Если указанный уровень доступа не настроен в проекте, то объекту будет присвоен уровень доступа private.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое используется в вашей инсталляции VK Object Storage. Формат имени может отличаться. Чтобы узнать точный формат ссылки обратитесь к вашему администратору.

   Время модификации объектов обновится. Учитывайте это при управлении жизненным циклом (lifecycle) объектов и использовании условных запросов (if-modified-since).

   Пример команды настройки доступа к объекту

 
aws s3 cp s3://my-bucket s3://my-bucket \  --acl public-read \  --recursive \  --endpoint-url https://hb.ru-msk.vkcloud-storage.ru

1. Установите и настройте SDK для Go, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   package mainimport (    "fmt"    "github.com/aws/aws-sdk-go/aws"    "github.com/aws/aws-sdk-go/aws/session"    "github.com/aws/aws-sdk-go/service/s3"    "log"    "strings")const (    vkCloudHotboxEndpoint = "https://hb.ru-msk.vkcloud-storage.ru"    defaultRegion         = "ru-msk")func main() {    // Создание сессии    sess, _ := session.NewSession()    // Подключение к сервису VK Object Storage    svc := s3.New(sess, aws.NewConfig().WithEndpoint(vkCloudHotboxEndpoint).WithRegion(defaultRegion))    // Копирование объекта из одного бакета в другой    sourceBucket := "gobucket"    sourceKey := "test_string.txt"    destBucket := "gobucket2"    destKey := "test_string.txt"    if _, err := svc.CopyObject(&s3.CopyObjectInput{ 	   Bucket:     aws.String(destBucket), 	   Key:        aws.String(destKey), 	   CopySource: aws.String(fmt.Sprintf("%s/%s", sourceBucket, sourceKey)),    }); err != nil { 	   log.Fatalf("Unable to copy object from %q to %q, %v\n", sourceBucket, destBucket, err)    } else { 	   fmt.Printf("Object copied from %q to %q\n", sourceBucket, destBucket)    }}

   Команда CopyObject подробно описана в официальной документации к библиотеке aws-sdk-go.

1. Установите и настройте SDK для Python, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   import boto3session = boto3.session.Session()s3_client = session.client(service_name='s3', endpoint_url='https://hb.ru-msk.vkcloud-storage.ru')source_bucket_name = 'boto3-source-bucket-name'source_path = 'object_key1.txt'target_bucket_name = 'boto3-target-bucket-name'target_path = 'backup/copy_object_key1.txt'copy_source = {   'Bucket': source_bucket_name,   'Key': source_path}s3_client.copy(copy_source, target_bucket_name, target_path)

   Команда copy подробно описана в официальной документации к библиотеке boto3.

1. На правой панели файлового менеджера откройте VK Object Storage и перейдите в нужный бакет. Найдите файл, который вы планируете удалить и вызовите для него контекстное меню правой кнопкой мыши.

   Или, выберите нужный файл и нажмите кнопку Delete на панели инструментов файлового менеджера.

2. В открывшемся диалоговом окне можно подтвердить или отменить удаление файла.

1. Установите и настройте AWS CLI, если он еще не установлен.

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

   Удаление одного объекта

   Удаление нескольких объектов

    
   aws s3 rm s3://<ИМЯ_БАКЕТА>/<КЛЮЧ_ОБЪЕКТА> --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <ИМЯ_БАКЕТА> — имя бакета, в котором находится нужный объект.

   • <КЛЮЧ_ОБЪЕКТА> — имя объекта и путь до него, включая директории, если они есть.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое было указано при установке сервиса.

   1. Проверьте, какие файлы будут удалены:

       
      aws s3 rm s3://<ИМЯ_БАКЕТА>/<ПРЕФИКС> --recursive --dryrun --endpoint-url <ENDPOINT_URL>

   2. Если список удаляемых файлов корректный, выполните удаление:

       
      aws s3 rm s3://<ИМЯ_БАКЕТА>/<ПРЕФИКС> --recursive --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <ИМЯ_БАКЕТА> — имя бакета, в котором находится нужный объект.

   • <ПРЕФИКС> — общий префикс для всех ключей объектов, которые необходимо удалить. При указании пустого префикса удаляются все объекты в бакете.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое было указано при установке сервиса.

   Пример команды удаления одного объекта
   Пример команды удаления нескольких объектов

Описание доступных параметров для команды удаления объектов — в официальной документации AWS CLI.

1. Установите и настройте SDK для Go, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   package mainimport (    "github.com/aws/aws-sdk-go/aws"    "github.com/aws/aws-sdk-go/aws/session"    "github.com/aws/aws-sdk-go/service/s3"    "log"    "strings")const (    vkCloudHotboxEndpoint = "https://hb.ru-msk.vkcloud-storage.ru"    defaultRegion = "ru-msk")func main() {    // Создание сессии    sess, err := session.NewSession()    if err != nil { 	   log.Fatalf("Unable to create session, %v", err)    }    // Подключение к сервису VK Object Storage    svc := s3.New(sess, aws.NewConfig().WithEndpoint(vkCloudHotboxEndpoint).WithRegion(defaultRegion))    // Удаление объекта из бакета   bucket := "gobucket"    key := "test_string.txt"    if _, err := svc.DeleteObject(&s3.DeleteObjectInput{ 	   Bucket: aws.String(bucket), 	   Key:    aws.String(key),    }); err != nil { 	   log.Fatalf("Unable to delete object %q from bucket %q, %v\n", key, bucket, err)    } else { 	   log.Printf("Object %q deleted from bucket %q\n", key, bucket)    }   // Удаление множества объектов    if _, err := svc.DeleteObjects(&s3.DeleteObjectsInput{ 	   Bucket: aws.String(bucket), 	   Delete: &s3.Delete{ 		   Objects: []*s3.ObjectIdentifier{ 			   { 				   Key: aws.String("test_string1.txt"), 			   }, 			   { 				   Key: aws.String("test_string2.txt"), 			   }, 		   }, 	   },    }); err != nil { 	   log.Fatalf("Unable to delete objects from bucket %q, %v\n", bucket, err)    } else { 	   log.Printf("Objects deleted from bucket %q\n", bucket)    }}

   Команды DeleteObject и DeleteObjects подробно описаны в официальной документации к библиотеке aws-sdk-go.

1. Установите и настройте SDK для Python, если он еще не установлен.

2. Добавьте реквизиты подключения к VK Object Storage в переменные окружения или конфигурационный файл, если этого не было сделано ранее.

3. Добавьте код в свой проект:

    
   import boto3session = boto3.session.Session()s3_client = session.client(service_name='s3', endpoint_url='https://hb.ru-msk.vkcloud-storage.ru')test_bucket_name = 'boto3-test-bucket-name'#Удаление одного объектаs3_client.delete_object(Bucket='boto3-bucket-name-test', Key='object_name.txt',)#Удаление множества объектовobject_to_delete = [{'Key':'objectkey1.txt'}, {'Key':'objectkey2.txt'}]s3_client.delete_objects(Bucket=test_bucket_name, Delete={'Objects': object_to_delete})

   Команда delete_objects подробно описана в официальной документации к библиотеке boto3.

1. Установите и настройте AWS CLI, если он еще не установлен. Установите выходной формат JSON или YAML, так как текстовые форматы не распознаются при выполнении команд составной загрузки или удаления.

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

    
   aws s3api list-multipart-uploads \   --bucket <ИМЯ_БАКЕТА> \   --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <ИМЯ_БАКЕТА> — имя бакета, для которого нужно удалить незавершенные загрузки.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое используется в вашей инсталляции VK Object Storage. Формат имени может отличаться. Чтобы узнать точный формат ссылки обратитесь к вашему администратору.

   Пример команды просмотра незавершенных загрузок

1. Установите и настройте AWS CLI, если он еще не установлен. Установите выходной формат JSON или YAML, так как текстовые форматы не распознаются при выполнении команд составной загрузки или удаления.

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

    
   aws s3api abort-multipart-upload \   --bucket <ИМЯ_БАКЕТА> \   --key <КЛЮЧ_ОБЪЕКТА> \   --upload-id <ID_ЗАГРУЗКИ> \   --endpoint-url <ENDPOINT_URL>

   Здесь:

   • <ИМЯ_БАКЕТА> — имя бакета, для которого нужно удалить незавершенные загрузки.

   • <КЛЮЧ_ОБЪЕКТА> — значение в поле Название на вкладке Multipart в личном кабинете или значение параметра Key в ответе AWS CLI.

   • <ID_ЗАГРУЗКИ> — значение в поле ID на вкладке Multipart в личном кабинете или значение параметра UploadId в ответе AWS CLI.

   • <ENDPOINT_URL> — ссылка с доменным именем, которое используется в вашей инсталляции VK Object Storage. Формат имени может отличаться. Чтобы узнать точный формат ссылки обратитесь к вашему администратору.

   Пример выполнения команды:

    
   aws s3api abort-multipart-upload \   --bucket mybucket \   --key inupload.avi \   --upload-id \example3K1xj3g1KUb2pKeDAfeT2zP6K74XiyJtceMeXH \   --endpoint-url https://hb.ru-msk.vkcloud-storage.ru

В результате все незавершенные загрузки будут отменены, а загруженные части — удалены.