الانتقال إلى المحتوى الرئيسي
PATCH
تحديث قاعدة إنفاق
يتطلب spend_rules:write. تُدمج الحقول التي ترسلها مع القاعدة المحفوظة، ثم يُعاد فحص القاعدة كاملة. يستبدل destination_ids وجهات القاعدة؛ احذفه للإبقاء عليها. يؤدي تغيير إجراء قاعدة حاظرة أو نطاقها أو فترتها أو أساسها إلى رفع حظرها النشط.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

معلمات المسار

id
string<uuid>
مطلوب

معرّف قاعدة الإنفاق.

الجسم

application/json

حقول قاعدة الإنفاق المراد تغييرها؛ حقل واحد على الأقل. أدخل المبالغ بصيغة *_usd أو *_nanos (نانودولار دقيق)، لا كليهما. اضبط الحقل على null لمسحه.

name
string
Required string length: 1 - 100
enabled
boolean
metric
enum<string>

spend: بلغ الإنفاق threshold_amount. budget_percent: بلغ الإنفاق threshold_percents من الأساس. forecast: يبلغ الإنفاق المتوقع حتى نهاية الفترة العتبة. spike: الإنفاق خلال آخر window_hours يساوي spike_multiplier مرة على الأقل من وسيط النافذة نفسها خلال الأيام السبعة السابقة، ولا يقل عن spike_floor. balance: ينخفض رصيد مساحة العمل أو مدة كفايته عن العتبة.

الخيارات المتاحة:
spend,
budget_percent,
forecast,
spike,
balance
scope_type
enum<string>
الخيارات المتاحة:
workspace,
key,
member,
department,
model,
provider
scope_id
string | null

null لنطاق مساحة العمل؛ وإلا فمعرّف مفتاح أو معرّف مستخدم لعضو أو معرّف قسم أو معرّف نموذج أو معرّف مزوّد.

Maximum string length: 200
period
enum<string>

day أو week (بدءًا من الاثنين) أو month في المنطقة الزمنية للقاعدة، أو rolling على آخر window_hours.

الخيارات المتاحة:
day,
week,
month,
rolling
window_hours
integer | null

عدد ساعات نافذة rolling: نافذة الارتفاع المفاجئ لقواعد spike (56 على الأكثر، حتى تتسع الأيام السبعة السابقة لثلاث نوافذ) وفترة معدل الاستهلاك لقواعد balance. تكون null للفترات التقويمية.

النطاق المطلوب: 1 <= x <= 720
time_zone
string | null

المنطقة الزمنية وفق IANA للفترات التقويمية. القيمة null تستخدم المنطقة الزمنية للفوترة في مساحة العمل.

Maximum string length: 64
base_kind
enum<string> | null

ما تمثل threshold_percents نسبًا منه: amount (base_amount) أو workspace_budget أو key_limit (الفاصل base_ref الذي يجب أن يطابق الفترة) أو previous_period.

الخيارات المتاحة:
amount,
workspace_budget,
key_limit,
previous_period
base_ref
enum<string> | null
الخيارات المتاحة:
daily,
weekly,
monthly
base_amount_usd
number | null
base_amount_nanos
integer<int64> | null
threshold_percents
integer[] | null

حتى خمس نسب مئوية صحيحة من الأساس، مرتبة. يعمل كل منها مرة واحدة على الأكثر في الفترة؛ وعند تجاوز عدة حدود معًا يُرسل تنبيه واحد يذكر أعلاها.

Required array length: 1 - 5 elements
النطاق المطلوب: 1 <= x <= 1000
threshold_amount_usd
number | null
threshold_amount_nanos
integer<int64> | null
runway_days
integer | null
النطاق المطلوب: 1 <= x <= 365
spike_multiplier
number | null
spike_floor_usd
number | null
spike_floor_nanos
integer<int64> | null
action
enum<string>

notify، أو التنبيه ثم الحظر عندما يبلغ الإنفاق block_at_percent من الأساس أو block_at_amount. الحظر يتم بأفضل جهد ويعمل بعد بلوغ الحد ببضع دقائق. ما دام الحظر متوقفًا في البوابة، تُرفض القاعدة التي ستبدأ الحظر برمز 400، والقاعدة التي تحظر بالفعل تكتفي بالتنبيه.

الخيارات المتاحة:
notify,
block
block_at_percent
integer
النطاق المطلوب: 100 <= x <= 1000
block_at_amount_usd
number | null
block_at_amount_nanos
integer<int64> | null
block_free_models
boolean

ما إذا كان الحظر يوقف أيضًا الطلبات إلى النماذج المجانية.

cooldown_minutes
integer

الحد الأدنى من الدقائق بين التنبيهات لقواعد rolling وspike وbalance.

النطاق المطلوب: 5 <= x <= 43200
destination_ids
string<uuid>[]

وجهات الإشعار لتنبيهات هذه القاعدة. القيمة الفارغة تعني مسار Spend Alerts في مساحة العمل.

Maximum array length: 50

الاستجابة

تم تحديث قاعدة الإنفاق

data
object
مطلوب

قاعدة إنفاق: حدود بالدولار أو بالنسبة المئوية لنطاق وفترة تُرسل تنبيهًا، أو تنبه ثم تحظر. تُعاد المبالغ بالنانودولار وبالدولار الأمريكي.

آخر تعديل في ٣١ أكتوبر ٢٠٢٦