bytes somma il volume di caricamento di ogni cliente, permettendoti di fatturarlo. Il blueprint è incluso nel pacchetto npm @dodopayments/ingestion-blueprints come trackObjectStorage() e funziona con S3, Google Cloud Storage, Azure Blob Storage e altri servizi di object storage.
Casi d’uso
L’Object Storage Blueprint è adatto ai seguenti scenari:File Hosting
Fattura ai clienti il volume totale dei file che caricano.
Backup Services
Monitora i caricamenti dei dati di backup e addebita la quantità di dati caricati.
Media CDN
Monitora i caricamenti di contenuti multimediali e fattura il volume di caricamento. Per fatturare la larghezza di banda di distribuzione, usa lo Stream Blueprint.
Document Management
Monitora i caricamenti di documenti per cliente per applicare prezzi basati sull’utilizzo.
Usalo per fatturare in base al volume di caricamento per servizi di file hosting, media CDN e backup. Il blueprint conta i byte caricati, non i byte archiviati nel tempo.
Avvio rapido
Per monitorare i caricamenti, installa il pacchetto, crea un meter e invia un evento dopo ogni caricamento completato correttamente.1
Install the SDK
Installa il pacchetto Dodo Payments Ingestion Blueprints:
2
Get Your API Keys
Sono necessari due set di credenziali:
- Chiave API di Dodo Payments: creane una in Developer → API Keys nella dashboard di Dodo Payments e salvala in
DODO_PAYMENTS_API_KEY. Usa una chiave in modalità test durante lo sviluppo. Una chiave in modalità test funziona solo contest_mode. - Credenziali del provider di storage: le credenziali utilizzate dal tuo SDK di storage per AWS S3, Google Cloud Storage, Azure Blob Storage o un altro provider.
3
Create a Meter
Nella dashboard di Dodo Payments, vai su Products → Meters e fai clic su Create Meter. Imposta questi campi:
- Meter Name: un nome descrittivo, ad esempio
Storage Uploads. - Event Name:
object_storage_uploadoppure un nome a tua scelta. Deve corrispondere esattamente aeventNamenel codice (distinzione tra maiuscole e minuscole). - Aggregation Type: Sum, per sommare i byte caricati.
- Over Property:
bytes, per fatturare in base alla dimensione del caricamento. - Measurement Unit: l’unità mostrata sulle fatture, ad esempio
bytes.
4
Track Storage Usage
Invia l’evento dopo che la chiamata allo storage è completata correttamente. In questi esempi, un caricamento non riuscito genera un’eccezione prima dell’esecuzione di
trackObjectStorage(), quindi non viene fatturato.Configurazione
Configurazione dell’ingestion
Passa queste opzioni anew Ingestion():
string
obbligatorio
La tua chiave API di Dodo Payments dalla dashboard.
string
Modalità dell’ambiente:
test_mode o live_mode. Il valore predefinito è test_mode. Gli SDK di Dodo Payments utilizzano invece live_mode per impostazione predefinita, quindi imposta esplicitamente live_mode in produzione.string
obbligatorio
Il nome dell’evento che corrisponde a Event Name del meter (distinzione tra maiuscole e minuscole).
Opzioni per il monitoraggio di Object Storage
Passa queste opzioni atrackObjectStorage():
string
obbligatorio
L’ID cliente Dodo Payments da fatturare per il caricamento, ad esempio
cus_123.number
Numero di byte caricati. Obbligatorio per la fatturazione basata sui byte. Se lo ometti, l’evento non contiene un valore
bytes, ma viene comunque conteggiato in un meter Count.object
Metadati facoltativi sul caricamento, come il nome del bucket o il tipo di contenuto. Ogni valore deve essere una stringa, un numero o un booleano.