Licenze per funzionalità software e limiti di utilizzo
Un diritto all'esportazione differisce da 500 esportazioni al mese. RunFeature controlla l'autorizzazione; RunMeteredFeature conferma l'utilizzo dopo il successo aziendale.
Consenti 500 esportazioni al mese
Aggiungi l'esportazione alle funzionalità della policy, quindi una quota: esportazione funzionalità, limite 500, periodo mensile. Per impostazione predefinita, un ulteriore utilizzo viene rifiutato una volta esaurito. Per consentire l'eccedenza, impostarne il massimo; il sistema registra l'utilizzo in eccesso per il tuo sistema di ordini.
Le quote giornaliere e mensili vengono ripristinate a mezzanotte UTC; le quote a vita non vengono reimpostate. La modifica di un limite non cancella l'utilizzo consumato.
Conferma l'utilizzo dopo un'esportazione riuscita
Passa la callback aziendale al numero SDK. I nuovi lavori richiedono nuovi ID; i tentativi mantengono l'ID, la funzione e la quantità. Processi diversi non devono eseguire lo stesso lavoro contemporaneamente.
| Lingua | Chiamata d'affari con contatore |
|---|---|
| Go | client.RunMeteredFeature(ctx, "export", 1, jobID, exportReport) |
| Java | client.runMeteredFeature("export", 1, jobID, this::exportReport) |
| Node.js | await client.runMeteredFeature("export", 1, jobID, exportReport) |
| Python | client.run_metered_feature("export", 1, job_id, export_report) |
| C# | await client.RunMeteredFeature("export", 1, jobID, ExportReport) |
| C++ | client.RunMeteredFeature("export", 1, jobID, exportReport) |
| Rust | client.run_metered_feature("export", 1, &job_id, || export_report())? |
| Ruby | client.run_metered_feature("export", 1, job_id) { export_report } |
| C | ln_run_metered_feature(client, "export", 1, job_id, export_report, context) |
Configure a meter for the actual feature in your policy, then generate the AI integration prompt. AI should use the language's RunMeteredFeature with a stable business operation ID, preserving that ID when retrying the same task.
Se l'attività ha successo ma la conferma fallisce, riprovare lo stesso lavoro non fa altro che confermare; non ripete mai gli affari. Un arresto anomalo durante l'attività blocca la riproduzione automatica. Ispeziona il tuo risultato duraturo, quindi ResolveMeteredFeature conferma o annulla. L'utilizzo remoto e l'attività locale non sono una transazione.
Quando hai bisogno di controllare tu stesso le prenotazioni
- Crea e salva un ID lavoro per questa esportazione.
- Prenota un'unità ed esporta solo dopo essere in sospeso. impegnato significa il lavoro già finito; non eseguire nuovamente.
- Dopo aver esportato con successo e salvato il risultato, chiamare Commit per confermare l'utilizzo.
- Se l'esportazione non riesce prima del completamento, chiamare Annulla per rilasciare la sospensione senza consumare unità.
Per impostazione predefinita, mantiene gli ultimi 15 minuti, abbreviati con un ripristino UTC. I chiamanti diretti al numero API possono impostare reservation_seconds su 30-3600 secondi.
| Lingua | Prenota | Conferma/Annulla |
|---|---|---|
| Go | Reserve(ctx, "export", 1, jobID) | Commit / Cancel(ctx, hold.ID, jobID) |
| Java / Node.js | reserve("export", 1, jobID) | commit / cancel(id, jobID) |
| C | ln_reserve(client, "export", 1, jobID) | ln_commit / ln_cancel(client, id, jobID) |
| C++ / C# | Reserve("export", 1, jobID) | Commit / Cancel(id, jobID) |
| Python | reserve("export", 1, jobID) | commit / cancel(id, jobID) |
Come leggere i campi di risposta
| Campo | Significato |
|---|---|
| reservation_id / operation_id | ID prenotazione e ID lavoro originale; mantenere gli stessi valori per i tentativi. |
| status / expires_at | Stato di attesa e scadenza: in sospeso attende il completamento, impegnato viene addebitato, annullato viene rilasciato, scaduto è scaduto. |
| consumption.used / reserved | Confermato utilizza questo periodo/unità possedute da tutte le prenotazioni attive. |
| consumption.limit / remaining | Indennità di base/unità base disponibili. rimanente = max(0, limit - used - reserved), esclusa l'eccedenza consentita. |
| consumption.quantity / overage | Unità per questo lavoro/unità confermate superiori all'indennità di base; non viene riscosso alcun pagamento dal cliente. |
| consumption.period / reset_at | UTC periodo di utilizzo/prossimo ripristino; le indennità vitalizie hanno reset_at = null. |
Per i corpi delle richieste, le risposte e i tipi di campo, vedere Prenota, Impegna e Annulla nel riferimento API di runtime.
Una volta completata l'operazione, non annullare o esportare nuovamente. Conservare gli ID e il risultato e riprovare il commit. Se la sospensione è scaduta, mantieni il lavoro per la riconciliazione. L'utilizzo remoto e il lavoro aziendale locale non possono condividere una transazione atomica.
Consumare registra comunque l'utilizzo immediato. Utilizza le prenotazioni per evitare di addebitare il lavoro non riuscito. Tutti gli endpoint di utilizzo funzionale richiedono una connessione e sono esclusi dalle quattro operazioni fatturabili API della piattaforma.