AWS SDK для C++
AWS SDK для C++ — это комплект средств разработки для работы с сервисами AWS.
Подготовка к работе
-
Назначьте сервисному аккаунту роли, которые нужны для вашего проекта, например storage.editor на бакет — для работы с конкретным бакетом, или на каталог — для работы со всеми бакетами в каталоге. Подробнее о ролях см. на странице Управление доступом с помощью Yandex Identity and Access Management.
Чтобы работать с объектами в зашифрованном бакете, у пользователя или сервисного аккаунта вместе с ролью
storage.configurerдолжны быть следующие роли на ключ шифрования:kms.keys.encrypter— для чтения ключа, шифрования и загрузки объектов;kms.keys.decrypter— для чтения ключа, расшифровки и скачивания объектов;kms.keys.encrypterDecrypter— включает разрешения, предоставляемые ролямиkms.keys.encrypterиkms.keys.decrypter.
Подробнее см. Сервисные роли Key Management Service.
-
Создайте статический ключ доступа.
В результате вы получите данные статического ключа доступа. Для аутентификации в Object Storage вам понадобятся:
key_id— идентификатор статического ключа доступа;secret— секретный ключ.
Сохраните
key_idиsecret, так как повторное получение значения ключа будет невозможно.
Примечание
Сервисный аккаунт может просматривать список бакетов только в том каталоге, в котором он был создан.
Сервисный аккаунт может выполнять действия с объектами в бакетах, которые созданы в каталогах, отличных от каталога сервисного аккаунта. Для этого назначьте сервисному аккаунту роли на нужный каталог или бакет в нем.
Установка
Для установки AWS SDK для C++ воспользуйтесь инструкцией на сайте производителя.
Настройка
-
Создайте директорию для хранения аутентификационных данных и перейдите в нее:
Для macOS и Linux:
mkdir ~/.aws/Для Windows:
mkdir C:\Users\<имя_пользователя>\.aws\ -
В директории
.awsсоздайте файлcredentialsи скопируйте в него аутентификационные данные, полученные ранее:[default] aws_access_key_id = <идентификатор_статического_ключа> aws_secret_access_key = <секретный_ключ> -
Создайте файл
configс параметрами региона по умолчанию и скопируйте в него следующую информацию:[default] region = ru-central1 endpoint_url = https://storage.yandexcloud.netПримечание
Некоторые приложения, предназначенные для работы с Amazon S3, не позволяют указывать регион, поэтому Object Storage принимает также значение
us-east-1.
Для доступа к Object Storage используйте эндпоинт https://storage.yandexcloud.net.
Примеры кода
Смотри примеры кода C++ для работы с S3 от производителя.
Ниже представлен пример простой программы, иллюстрирующий отличие в настройках для Yandex Object Storage.
CmakeLists
cmake_minimum_required(VERSION 3.8)
project("s3-examples")
set(CMAKE_CXX_STANDARD 20)
if(NOT BUILD_SHARED_LIBS)
set(BUILD_SHARED_LIBS ON)
endif()
find_package(AWSSDK REQUIRED COMPONENTS s3 sts)
add_executable(EXAMPLE EXAMPLE_FILE_S3.cpp)
target_link_libraries(EXAMPLE ${AWSSDK_LINK_LIBRARIES}
${AWSSDK_PLATFORM_DEPS})
Файл EXAMPLE_FILE_S3.cpp
#include <aws/core/Aws.h>
#include <aws/core/auth/AWSCredentialsProvider.h>
#include <aws/s3/S3Client.h>
#include <aws/s3/model/Bucket.h>
#include <aws/s3/model/CreateBucketConfiguration.h>
#include <aws/s3/model/CreateBucketRequest.h>
#include <aws/s3/model/DeleteBucketRequest.h>
#include <aws/s3/model/ListObjectsRequest.h>
#include <aws/s3/model/PutObjectRequest.h>
#include <sys/stat.h>
#include <fstream>
#include <iostream>
// Находит бакет и выводит его содержимое в консоль
bool FindTheBucket(const Aws::S3::S3Client& s3Client, const Aws::String& bucketName)
{
Aws::S3::Model::ListBucketsOutcome outcome = s3Client.ListBuckets();
Aws::S3::Model::ListObjectsRequest request;
if (outcome.IsSuccess()) {
std::cout << "Looking for a bucket named '" << bucketName << "'..." << std::endl;
Aws::Vector<Aws::S3::Model::Bucket> bucket_list = outcome.GetResult().GetBuckets();
for (Aws::S3::Model::Bucket const& bucket : bucket_list) {
if (bucket.GetName() == bucketName) {
request.WithBucket(bucketName);
std::cout << "Found the bucket." << std::endl << std::endl;
auto outcome_obj = s3Client.ListObjects(request);
std::cout << "Objects in bucket '" << bucketName << "':" << std::endl;
Aws::Vector<Aws::S3::Model::Object> objects = outcome_obj.GetResult().GetContents();
for (Aws::S3::Model::Object& object : objects) {
std::cout << object.GetKey() << std::endl;
}
return true;
}
}
std::cout << "Could not find the bucket." << std::endl << std::endl;
return true;
} else {
std::cout << "ListBuckets error: " << outcome.GetError().GetMessage() << std::endl;
}
return false;
}
int main(int argc, char* argv[])
{
Aws::SDKOptions options;
Aws::InitAPI(options);
{
// Секция настроек для использования AWS SDK с Object Storage
Aws::Client::ClientConfiguration config;
config.region = Aws::String("ru-central1");
config.endpointOverride = Aws::String("storage.yandexcloud.net");
Aws::String bucket_name = "bucket_name";
// Инициализация подключения
Aws::S3::S3Client s3_client(config);
FindTheBucket(s3_client, bucket_name);
}
Aws::ShutdownAPI(options);
return 0;
}