Skip to content
Bitzsoft.Integrationsbitzsoft.integrations

Reference

阿里云 OSS

阿里云 OSS 文件存储包的 AliyunOssOptions 配置字段、Endpoint 鉴权与使用示例。

Last updated

包信息

属性
NuGet 包Bitzsoft.Integrations.FileStorage.Aliyun
Provider IDaliyun
鉴权AccessKeyId + AccessKeySecret(HMAC 签名)

配置字段(AliyunOssOptions)

字段类型必填默认值说明
Endpointstring存储服务地址(如 oss-cn-hangzhou.aliyuncs.com
AccessKeyIdstring访问密钥 ID
AccessKeySecretstring访问密钥密码
DefaultBucketNamestring默认存储桶名称
UploadUrlExpirationint3600上传地址过期时间(秒)
DownloadUrlExpirationint3600下载地址过期时间(秒)

配置示例

{
"FileStorage": {
"Aliyun": {
"Endpoint": "oss-cn-hangzhou.aliyuncs.com",
"AccessKeyId": "LTAIxxxxxxxx",
"AccessKeySecret": "your-secret-key",
"DefaultBucketName": "my-bucket"
}
}
}

DI 注册

builder.Services.AddBitzsoftAliyunOssFileStorage(builder.Configuration.GetSection("FileStorage:Aliyun"));

使用示例

public class FileService(IFileStore store)
{
public async Task<string> UploadAsync(Stream stream, string fileName)
{
var result = await store.SaveFileAsync(stream, fileName);
return result.Url;
}
public async Task<string> GetDownloadUrlAsync(string fileName)
{
return await store.GenerateDownloadUrlAsync(fileName);
}
}

已知限制

  • Endpoint 必须与桶所在区域一致,否则签名校验失败。

相关

100%

滚轮或按钮缩放 · 放大后拖动画面 · 双击切换 100% / 200%