.NET Core AWS S3雲端儲存

Jeffcky發表於2020-12-25

前言

最近有需要用到AWS S3雲端儲存上傳附件,這裡對利用.NET或.NET Core在呼叫SDK APi需要注意的一點小問題做個記錄,或許能對後續有用到的童鞋提供一點幫助

AWS S3雲端儲存

官方已提供針對.NET/.NET Core針對S3的APi(https://docs.aws.amazon.com/sdkfornet/v3/apidocs/)和SDK demo(https://github.com/awslabs/aws-sdk-net-samples),首先我們下載針對.NET Core的SDK包(AWSSDK.Core)以及通過S3儲存物件包(AWSSDK.S3),如下圖所示

接下來我們再利用官方所給SDK Demo,此時並不能直接複製拿來使用,如下:

using (client = new AmazonS3Client(RegionEndpoint.USWest2))
{
    Console.WriteLine("Listing buckets");
    ListingBuckets();

    Console.WriteLine("Creating a bucket");
    CreateABucket();

    Console.WriteLine("Writing an object");
    WritingAnObject();

    Console.WriteLine("Reading an object");
    ReadingAnObject();

    Console.WriteLine("Deleting an object");
    DeletingAnObject();

    Console.WriteLine("Listing objects");
    ListingObjects();
}

AWS S3上傳附件要提供上傳憑證和配置,AK(awsAccessKeyId)和SK(awsSecretAccessKey)作為憑證。Region(awsRegion)和EndPoint(awsEndPoint)作為配置,大部分情況下我們都是利用如下構造

public AmazonS3Client(AWSCredentials credentials, AmazonS3Config clientConfig);

因憑證就是AK/SK,我們也可直接提供ak、sk,如下構造,一切根據實際業務對接情況而具體分析

public AmazonS3Client(string awsAccessKeyId, string awsSecretAccessKey, AmazonS3Config clientConfig);

通過官網介紹,憑證可以通過配置檔案、環境變數等等共享,這一塊並不是重點,未細看,請忽略,我直接將其存放到配置檔案中。最終構造AWSS3Client,如下程式碼:

//提供awsAccessKeyId和awsSecretAccessKey構造憑證
var credentials = new BasicAWSCredentials(awsAccessKeyId, awsSecretAccessKey);

//提供awsEndPoint(域名)進行訪問配置
var clientConfig = new AmazonS3Config
{
    ServiceURL = awsEndPoint
};

var amazonS3Client = new AmazonS3Client(credentials, clientConfig);

AWS提供了常用的ReginEndPoint,但若對接方提供了自定義Region,則需通過如下配置獲取RegionEndPoint

var clientConfig = new AmazonS3Config
{
    RegionEndpoint = RegionEndpoint.GetBySystemName(awsRegion),
    ServiceURL = awsEndPoint
};

此時再執行將會丟擲如下異常:

此時針對上述訪問配置,繼續配置ForcePathStyle為true,說明請求都將採用路徑風格地址,據猜測我們使用指定域名(ServiceURL)來傳送請求,所以應該必須指定此屬性。

var clientConfig = new AmazonS3Config
{
    RegionEndpoint = RegionEndpoint.GetBySystemName(awsRegion),
    ServiceURL = awsEndPoint,
    ForcePathStyle = true
};

總結

利用.NET Core在AWS S3儲存物件時暫遇到或需注意上述兩個小問題,在此做一記錄,若能幫到有需要的童鞋,將再好不過了。

相關文章