Expero.Libraries.CSharp.ObjectStorage.S3

Пакет для работы c S3-like ObjectStorage.

Пакет содержит:

• Сервис для работы c S3-like ObjectStorage
• Health метрика для работы c S3-like ObjectStorage

Работа с IObjectStorageS3Service

Пример подключения:

services.AddMdsObjectStorageS3Service(s =>
{
    var credentials = //...

    s.Host = credentials.Host; // Хост для подключеня
    s.Ssl = credentials.Ssl; // Используем ли мы SSL для работы
    s.AccessKey = credentials.AccessKey; // AccessKey для подключеня
    s.SecretKey = credentials.SecretKey; // SecretKey для подключеня
    s.DefaultBucket = credentials.DefaultBucket; // Какой бакет будет использоваться для проверки подключения и для загрузки файлов по умолчанию 
});

Рекоменудуем подключать на уровне Core.Tools, и там же положить фабрику для имен бакетов, если планируется использовать несколько бакетов для работы.

Например, вот так:

public static class ObjectStorageBuckets
{
    // NB: Имена необходимо указывать в lowercase
    public static ObjectStorageS3BucketName Default { get; } = new("default");

    public static ObjectStorageS3BucketName Feeds { get; } = new("feeds");
}

Директории

При сохранении файлов в бакет, библиотека позволяет прописать директорию внутри бакета, если директория не существует, то она будет создана.

Например, если нам нужно сохранить какой-либо контент в бакет по директории dir/sub_dir/sub_sub_dir/, то код будет выглядеть так:

// Для сохранения можно использовать следующий метод из IObjectStorageS3Service
Task<FileUploadResult> IObjectStorageS3Service.UploadAsync(byte[] content, UploadParameters parameters);

Пример использования:

IObjectStorageS3Service _objectStorage; // получаем через DI

var parameters = new UploadParameters
{
    Bucket = new ObjectStorageS3BucketName("my-test-bucket"),
    Directory = "dir/sub_dir/sub_sub_dir/",
    FileName = "may-test-image.png"
};

var result = await _objectStorage.UploadAsync(content, parameters);