包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.FileStorage.Aliyun |
| Provider ID | aliyun |
| 鉴权 | AccessKeyId + AccessKeySecret(HMAC 签名) |
配置字段(AliyunOssOptions)
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Endpoint | string | 是 | — | 存储服务地址(如 oss-cn-hangzhou.aliyuncs.com) |
AccessKeyId | string | 是 | — | 访问密钥 ID |
AccessKeySecret | string | 是 | — | 访问密钥密码 |
DefaultBucketName | string | 是 | — | 默认存储桶名称 |
UploadUrlExpiration | int | 否 | 3600 | 上传地址过期时间(秒) |
DownloadUrlExpiration | int | 否 | 3600 | 下载地址过期时间(秒) |
配置示例
{ "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 必须与桶所在区域一致,否则签名校验失败。
相关
- 文件存储域手册:胖接口设计