探索对象存储蓝图支持的常见场景：
File Hosting
根据总存储使用量和上传量向客户收费。
Backup Services
跟踪备份数据上传并按每 GB 存储收费。
Media CDN
监控媒体上传并按存储和带宽计费。
Document Management
按客户跟踪文档上传以实现基于使用量的定价。
非常适合基于存储上传、文件托管、CDN 使用或备份服务的计费。
快速开始
跟踪对象存储上传的字节消耗：
Install the SDK
npm install @dodopayments/ingestion-blueprints
Create a Meter
在您的 Dodo Payments Dashboard 中创建计量器：
- Event Name：
object_storage_upload（或您首选的名称）
- Aggregation Type：
sum，以跟踪总上传字节数
- Over Property：
bytes，用于基于存储大小计费
Track Storage Usage
import { Ingestion, trackObjectStorage } from '@dodopayments/ingestion-blueprints';
import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
import fs from 'fs';
const ingestion = new Ingestion({
apiKey: process.env.DODO_PAYMENTS_API_KEY,
environment: 'test_mode',
eventName: 'object_storage_upload'
});
const s3 = new S3Client({ region: 'us-east-1' });
// Read the file (example: from disk or request)
const fileBuffer = fs.readFileSync('./document.pdf');
// Upload to S3
const command = new PutObjectCommand({
Bucket: 'my-bucket',
Key: 'uploads/document.pdf',
Body: fileBuffer
});
await s3.send(command);
// Track the upload
await trackObjectStorage(ingestion, {
customerId: 'customer_123',
bytes: fileBuffer.length
});
数据摄取配置
来自控制面板的 Dodo Payments API 密钥。
环境模式：test_mode 或 live_mode。
跟踪对象存储选项
关于上传的可选元数据，例如存储桶名称、内容类型等。
最佳实践
在上传前后跟踪：根据您的错误处理策略，可以在实际上传之前或之后跟踪事件。
处理上传失败：仅跟踪成功上传，以避免对失败操作计费。
