سافٹ ویئر خصوصیات کے لائسنس اور استعمال کی حدود
برآمد کی اجازت اور ماہانہ ۵۰۰ برآمد الگ اصول ہیں۔ RunFeature اجازت جانچتا ہے؛ RunMeteredFeature کامیابی کے بعد استعمال کی تصدیق کرتا ہے۔
ماہ میں 500 export دیں
پالیسی میں export اور کوٹا دیں: export، 500، ماہانہ۔ ختم پر اصل قاعدہ رد کرتا ہے۔ اضافی اجازت کی زیادہ حد دیں؛ نظام اضافی استعمال آپ کے آرڈر سسٹم کے لیے گنتا ہے۔
روزانہ اور ماہانہ کوٹا UTC نصف شب reset؛ مجموعی نہیں۔ حد بدلنے سے پچھلا استعمال نہیں مٹتا۔
کامیاب برآمد کے بعد استعمال کی تصدیق
اپنی کارروائی SDK کو دیں۔ نئے کام کے لیے نیا ID؛ دوبارہ کوشش میں وہی ID، خصوصیت اور مقدار رکھیں۔ مختلف پراسیس ایک ID بیک وقت نہ چلائیں۔
| زبان | گنتی والی کارروائی کی کال |
|---|---|
| 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.
کام کامیاب اور تصدیق ناکام ہو تو دوبارہ کوشش صرف تصدیق کرتی ہے، کام نہیں دہراتی۔ دوران کارروائی کریش خودکار تکرار روکتا ہے۔ مستقل نتیجہ جانچ کر ResolveMeteredFeature سے تصدیق یا منسوخی کریں۔ دور کی گنتی اور مقامی کام ایک ٹرانزیکشن نہیں۔
جب بکنگ کے عمل کو خود کنٹرول کرنا ہو
- اس برآمد کے کام کی شناخت بنائیں اور محفوظ کریں۔
- ایک مقدار Reserve کریں، pending پر برآمد کریں۔ committed یعنی کام ہوچکا؛ دوبارہ نہ کریں۔
- برآمد کامیاب ہو اور نتیجہ محفوظ ہو تو Commit سے استعمال کی تصدیق کریں۔
- برآمد مکمل ہونے سے پہلے ناکام ہو تو Cancel سے محفوظ مقدار آزاد کریں؛ استعمال نہیں کٹے گا۔
محفوظ مقدار کی پیش فرض مدت 15 منٹ؛ UTC مدت کی تبدیلی پر پہلے ختم ہوگی۔ API میں reservation_seconds کو 30–3600 سیکنڈ رکھ سکتے ہیں۔
| زبان | محفوظ کرنا | تصدیق / منسوخی |
|---|---|---|
| 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) |
جواب کے فیلڈ کیسے سمجھیں؟
| فیلڈ | مطلب |
|---|---|
| reservation_id / operation_id | محفوظ مقدار اور اصل کام کی شناخت؛ دوبارہ کوشش میں یہی اقدار دیں۔ |
| status / expires_at | حالت اور آخری وقت: pending نامکمل، committed استعمال کٹ چکا، canceled آزاد، expired مدت ختم۔ |
| consumption.used / reserved | اس مدت میں تصدیق شدہ استعمال / تمام فعال کاموں کی محفوظ مقدار۔ |
| consumption.limit / remaining | بنیادی حد / دستیاب بنیادی مقدار۔ remaining = max(0, limit - used - reserved)، اجازت یافتہ اضافی استعمال شامل نہیں۔ |
| consumption.quantity / overage | اس کام کی مقدار / بنیادی حد سے زائد تصدیق شدہ استعمال؛ صارف سے رقم وصول نہیں ہوتی۔ |
| consumption.period / reset_at | UTC استعمال کی مدت / اگلا ری سیٹ؛ عمر بھر کی حد میں reset_at = null۔ |
درخواست، جواب اور فیلڈ کی اقسام کے لیے رن ٹائم API میں Reserve، Commit اور Cancel دیکھیں۔
کامیابی کے بعد منسوخ یا دوبارہ برآمد نہ کریں۔ شناخت اور نتیجہ رکھ کر Commit دوبارہ کریں۔ محفوظ مقدار کی مدت ختم ہو تو کام جانچ کے لیے رکھیں۔ دور کا استعمال اور مقامی کام ایک ایٹمی لین دین نہیں بنتے۔
Consume فوراً استعمال شمار کرتا ہے۔ ناکام کام نہ کٹے تو محفوظ مقدار لیں۔ خصوصیت کے تمام شمار آن لائن ہیں اور پلیٹ فارم کے چار قابل بل API عمل میں شامل نہیں۔