ملاحظة
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يمكنك استخدام التنفيذ التلقائي لإدارة التكلفة لإنشاء مجموعة مخصصة من الحلول للحصول على بيانات التكلفة وإدارتها. تتناول هذه المقالة السيناريوهات الشائعة للتنفيذ التلقائي لإدارة التكلفة والخيارات المتوفرة استناداً إلى موقفك. إذا كنت ترغب في تطوير باستخدام واجهات برمجة التطبيقات، توجد أمثلة طلب واجهة برمجة التطبيقات الشائعة ويتم عرضها للمساعدة في تسريع عملية التطوير.
التنفيذ التلقائي للحصول على بيانات التكلفة لتحليلها دون اتصال بالإنترنت
قد تحتاج إلى تنزيل بيانات تكلفة Azure لدمجها مع مجموعات بيانات أخرى. أو قد تحتاج إلى دمج بيانات التكلفة في أنظمتك الخاصة. تُتاح خيارات مختلفة استناداً إلى كمية البيانات المطلوبة. يجب أن يكون لديك أذونات إدارة التكلفة في النطاق المناسب لاستخدام واجهات برمجة التطبيقات والأدوات في أي حالة من الحالات. لمزيد من المعلومات، راجع تعيين الوصول إلى البيانات.
اقتراحات لمعالجة مجموعات البيانات الكبيرة
إذا كان لدى مؤسستك وجود Azure كبير عبر العديد من الموارد أو الاشتراكات، فسيكون لديك عدد كبير من نتائج بيانات تفاصيل الاستخدام. وغالباً لا يمكن لبرنامج Excel تحميل مثل هذه الملفات الكبيرة. وفي هذه الحالة، نوصي الخيارات التالية:
Power BI
يُستخدم Power BI لاستيعاب كميات كبيرة من البيانات والتعامل معها. إذا كنت عميلاً لاتفاقية Enterprise، فيمكنك استخدام تطبيق قالب Power BI لتحليل تكاليف حساب الفوترة. يحتوي التقرير على طرق عرض رئيسية يستخدمها العملاء. لمزيد من المعلومات، راجع تحليل تكاليف Azure باستخدام تطبيق قالب Power BI.
موصل بيانات POWER BI
إذا كنت ترغب في تحليل بياناتك يومياً، نوصي باستخدام موصل بيانات Power BI للحصول على بيانات لتحليل مفصل. يحتفظ الموصل بالتقارير محدثة مع تراكم المزيد من التكاليف.
عمليات تصدير إدارة التكلفة
ربما لا تحتاج إلى تحليل البيانات يومياً. إذا كان الأمر كذلك، ففكر في استخدام ميزة عمليات تصدير إدارة التكلفة لجدولة تصدير البيانات إلى حساب تخزين Azure. ويمكنك بعد ذلك تحميل البيانات في Power BI حسب الحاجة، أو تحليلها في برنامج Excel إذا كان الملف صغيراً بدرجة كافية. وتتوفر عمليات التصدير في مدخل Microsoft Azure أو يمكنك تكوين عمليات التصدير باستخدام واجهة برمجة تطبيقات عمليات التصدير.
تفاصيل التكلفة واجهة برمجة التطبيقات
ضع في اعتبارك استخدام واجهة برمجة تطبيقات تفاصيل التكلفة إذا كان لديك مجموعة بيانات تكلفة صغيرة. إليك أفضل الممارسات الموصى بها:
- إذا كنت تريد الحصول على أحدث بيانات التكلفة، نوصي بالاستعلام مرة واحدة على الأكثر في اليوم. يتم تحديث التقارير كل أربع ساعات. إذا قمت بالاتصال بشكل متكرر، فستتلقى بيانات متطابقة.
- بمجرد تنزيل بيانات التكلفة الخاصة بك للفواتير التاريخية، لا يتوقع أن تتغير الرسوم ما لم يتم إعلامك بشكل صريح. نوصي بالتخزين المؤقت لبيانات التكلفة في مخزن قابل للاستعلام لمنع الاستدعاءات المتكررة للحصول على بيانات متطابقة.
- قم بتقسيم مكالماتك إلى نطاقات تاريخ صغيرة للحصول على ملفات أكثر قابلية للإدارة يمكنك تنزيلها. على سبيل المثال، نوصي بالتقسيم حسب اليوم أو الأسبوع إذا كان لديك ملفات استخدام Azure كبيرة من شهر إلى شهر.
- إذا كانت لديك نطاقات بها كمية كبيرة من بيانات التكلفة (على سبيل المثال حساب فوترة)، ففكر في إجراء مكالمات متعددة إلى النطاقات التابعة حتى تحصل على ملفات أكثر قابلية للإدارة يمكنك تنزيلها.
- إذا كانت مجموعة البيانات الخاصة بك أكثر من 2 غيغابايت شهريًا، ففكر في استخدام عمليات التصدير كحل أكثر قابلية للتطوير.
أتمتة الاسترداد باستخدام واجهة برمجة تطبيقات تفاصيل التكلفة
تقوم واجهة برمجة تطبيقات تفاصيل التكلفة بإنشاء بيانات التكلفة التفصيلية وغير المجمعة وتنزيلها برمجيا لحساب فوترة اتفاقية Enterprise (EA) أو اتفاقية عملاء Microsoft (MCA). على عكس واجهة برمجة تطبيقات تفاصيل الاستخدام القديمة، فإن واجهة برمجة تطبيقات تفاصيل التكلفة غير متزامنة وقائمة على التقرير: يمكنك إرسال طلب لإنشاء تقرير، والاستقصاء عن اكتماله، ثم تنزيل الملف الناتج من عنوان URL آمن.
هام
يتم دعم واجهة برمجة تطبيقات تفاصيل التكلفة فقط لنطاقات اتفاقية Enterprise (EA) أو اتفاقية عملاء Microsoft (MCA). بالنسبة إلى أنواع الحسابات الأخرى، نقترح استخدام عمليات التصدير. إذا كنت بحاجة إلى تنزيل مجموعات بيانات صغيرة ولا تريد استخدام Azure Storage، يمكنك أيضا استخدام واجهة برمجة تطبيقات تفاصيل استخدام الاستهلاك. راجع إرشادات حول كيفية القيام بذلك هنا
كيفية عمل واجهة برمجة تطبيقات تفاصيل التكلفة
- إنشاء تقرير: إرسال طلب POST إلى واجهة برمجة تطبيقات تفاصيل التكلفة التي تحدد النطاق ونطاق التاريخ وعوامل التصفية الاختيارية (مثل العداد أو المورد أو العلامة).
- الاستقصاء عن الحالة: ترجع واجهة برمجة التطبيقات معرف عملية. قم باستطلاع نقطة نهاية حالة العملية حتى يكتمل التقرير.
- تنزيل التقرير: بمجرد أن يصبح التقرير جاهزا، توفر واجهة برمجة التطبيقات عنوان URL آمن للتنزيل لملف CSV الذي يحتوي على بيانات التكلفة الخاصة بك. ارتباط التنزيل صالح لفترة محدودة.
للحصول على التفاصيل الكاملة، راجع الحصول على مجموعات بيانات استخدام صغيرة عند الطلبومرجع واجهة برمجة تطبيقات تفاصيل التكلفة.
مثال: إنشاء تقرير تفاصيل التكلفة وتنزيله
لاسترداد تفاصيل التكلفة باستخدام واجهة برمجة تطبيقات تفاصيل التكلفة، اتبع الخطوات التالية:
الخطوة 1: إنشاء تقرير
إرسال طلب POST لبدء إنشاء التقرير. استبدل {scope} بحساب الفوترة أو نطاق ملف التعريف الخاص بك.
POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2025-03-01
Content-Type: application/json
{
"metric": "ActualCost",
"timePeriod": {
"start": "2025-03-01",
"end": "2025-03-15"
}
}
تتضمن الاستجابة عنوانا Location في الاستجابة يحتوي على ارتباط الاستقصاء الذي سيتم استخدامه في الخطوة 2.
الخطوة 2: الاستقصاء عن الحالة
تحقق من حالة إنشاء التقرير باستخدام ارتباط الاستقصاء:
GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport/{operationId}?api-version=2025-03-01
عندما يكون التقرير جاهزا، تتضمن الاستجابة خاصية blobLink .
الخطوة 3: تنزيل التقرير
blobLink استخدم لتنزيل ملف CSV الذي يحتوي على تفاصيل التكلفة.
إشعار
واجهة برمجة تطبيقات تفاصيل التكلفة غير متزامنة. لا يمكنك استرداد تفاصيل التكلفة مباشرة مع طلب GET إلى /generateCostDetailsReport. استخدم دائما سير عمل إنشاء التقرير الموضح أعلاه. لمزيد من المعلومات، راجع وثائق واجهة برمجة تطبيقات تفاصيل التكلفة.
أفضل الممارسات لاستخدام واجهة برمجة تطبيقات تفاصيل التكلفة
- تكرار الطلب: نوصي بعدم إنشاء التقارير أكثر من مرة واحدة في اليوم لنطاق معين ونطاق تاريخ معين. يتم تحديث بيانات التكلفة كل أربع ساعات، ولكن الطلبات الأكثر تكرارا ترجع نفس البيانات وقد يتم تقييدها.
- نطاق التاريخ: بالنسبة لمجموعات البيانات الكبيرة، حدد نطاق التاريخ (على سبيل المثال، إنشاء تقارير يومية أو أسبوعية) للحفاظ على أحجام الملفات قابلة للإدارة.
- النطاق: استخدم النطاق الأعلى مستوى المتاح (مثل حساب الفوترة أو ملف تعريف الفوترة) لتقليل عدد استدعاءات واجهة برمجة التطبيقات وضمان اكتمال البيانات.
- استبقاء البيانات: قم بتنزيل التقارير وتخزينها على الفور. تنتهي صلاحية عنوان URL للتنزيل بعد فترة قصيرة (عادة ساعة واحدة).
ملاحظات حول التسعير والبيانات
- توفر واجهة برمجة تطبيقات تفاصيل التكلفة بيانات التكلفة الفعلية والمطفأة، بما في ذلك جميع الاستخدام والمشتريات والمبالغ المستردة للفترة المحددة.
- البيانات غير مجمعة ومناسبة للتحليل التفصيلي والمصالحة والتكامل مع الأنظمة الأخرى.
- لمزيد من المعلومات حول سلوك التسعير، راجع سلوك التسعير في تفاصيل التكلفة.
قد يكون لمورد واحد العديد من السجلات في يوم واحد
قد يرسل موفرو موارد Azure الاستخدام والرسوم إلى نظام الفوترة بسمات مختلفة (مثل موقع مركز البيانات)، ما يؤدي إلى سجلات متعددة لمورد في يوم واحد. هذا السلوك متوقع ولا يشير إلى تكلفة زائدة؛ تمثل جميع السجلات معا التكلفة الكاملة لهذا المورد واليوم.
التنفيذ التلقائي للتنبيهات والإجراءات باستخدام الميزانيات
هناك عنصران حاسمان لتعظيم قيمة استثمارك في السحابة إلى أقصى حد. أحدهما هو لإنشاء التنفيذ التلقائي للموازنة. والآخر هو تكوين التزامن القائم على التكلفة استجابة لتنبيهات الميزانية. هناك طرق مختلفة لأتمتة إنشاء الموازنة. وتحدث استجابات تنبيه مختلفة عندما يتم تجاوز حدود التنبيه التي تم تكوينها.
تغطي الأقسام التالية الخيارات المتاحة وتوفر نماذج لطلبات واجهة برمجة التطبيقات لتبدأ في التنفيذ التلقائي للموازنة.
كيف يتم تقييم التكاليف مقابل حد موازنتك؟
يتم تقييم تكاليفك مقابل حد موازنتك مرة واحدة يومياً. عند إنشاء موازنة جديدة أو في يوم إعادة تعيين الموازنة، ستكون التكاليف مقارنة بالحد الأدنى صفرية/خالية لأن التقييم ربما لم يحدث بعد.
وعندما يكتشف Azure أن تكاليفك قد تجاوزت الحد الأدنى، يتم تشغيل إعلام في غضون ساعة من وقت الاكتشاف.
عرض التكلفة الحالية
تحتاج لعرض التكاليف الحالية إلى إجراء استدعاء GET باستخدام Query API.
لن يُرجع استدعاء GET إلى واجهة برمجة تطبيقات الموازنة التكاليف الحالية الموضحة في تحليل التكلفة. ويُرجع الاستدعاء بدلاً من ذلك آخر تكلفة تم تقييمها.
إنشاء التنفيذ التلقائي للموازنة
يمكنك إنشاء التنفيذ التلقائي للموازنة باستخدام واجهة برمجة تطبيقات الموازنة. يمكنك أيضاً إنشاء موازنة باستخدام قالب الموازنة. وتعد القوالب طريقة سهلة لتوحيد عمليات نشر Azure مع ضمان تكوين التحكم في التكلفة وفرضه بشكل صحيح.
اللغات المدعومة لرسائل البريد الإلكتروني لتنبيهات الموازنة
يتم تنبيهك من خلال الموازنات عندما تتجاوز التكاليف حد محدد. ويمكنك إعداد ما يصل إلى خمسة مستلمين للبريد الإلكتروني لكل موازنة. يتلقى المستلمون تنبيهات البريد الإلكتروني في غضون 24 ساعة من تجاوز حد الموازنة. ومع ذلك، قد يحتاج المستلم إلى تلقي بريد إلكتروني بلغة مختلفة. يمكنك استخدام رموز ثقافة اللغة التالية مع واجهة برمجة تطبيقات الموازنات. عيّن رمز الثقافة باستخدام المعلمة locale على غرار المثال التالي.
{
"eTag": "\"1d681a8fc67f77a\"",
"properties": {
"timePeriod": {
"startDate": "2020-07-24T00:00:00Z",
"endDate": "2022-07-23T00:00:00Z"
},
"timeGrain": "BillingMonth",
"amount": 1,
"currentSpend": {
"amount": 0,
"unit": "USD"
},
"category": "Cost",
"notifications": {
"actual_GreaterThan_10_Percent": {
"enabled": true,
"operator": "GreaterThan",
"threshold": 20,
"locale": "en-us",
"contactEmails": [
"user@contoso.com"
],
"contactRoles": [],
"contactGroups": [],
"thresholdType": "Actual"
}
}
}
}
اللغات المدعومة بواسطة رمز الثقافة:
| رمز الثقافة | اللغة |
|---|---|
| ar | الإنجليزية (الولايات المتحدة) |
| ja-jp | اليابانية (اليابان) |
| zh-cn | الصينية (المبسطة، الصين) |
| de-de | الألمانية (ألمانيا) |
| es-es | الإسبانية (إسبانيا، دولي) |
| fr-fr | الفرنسية (فرنسا) |
| it-it | الإيطالية (إيطاليا) |
| ko-kr | الكورية (كوريا) |
| البرتغالية (البرازيل) | البرتغالية (البرازيل) |
| الروسية (روسيا) | الروسية (روسيا) |
| zh-tw | الصينية (التقليدية، تايوان) |
| cs-cz | التشيكية (جمهورية التشيك) |
| pl-pl | البولندية (بولندا) |
| tr-tr | التركية (Türkiye) |
| da-dk | الدانماركية (الدانمرك) |
| الإنجليزية (المملكة المتحدة) | الإنجليزية (المملكة المتحدة) |
| hu-hu | المجرية (المجر) |
| النرويجية | بوكمول النرويجية (النرويج) |
| nl-nl | الهولندية (هولندا) |
| pt-pt | البرتغالية (البرتغال) |
| sv-se | السويدية (السويد) |
التكوينات الشائعة لواجهة برمجة تطبيقات الموازنات
هناك العديد من الطرق لتكوين موازنة في بيئة Azure. خذ بعين الاعتبار السيناريو أولاً ثم حدد خيارات التكوين التي تمكّنه. راجع الخيارات التالية:
- الفاصل الزمني - يمثل الفترة المتكررة التي تستخدمها موازنتك لتراكم وتقييم التكاليف. الخيارات الأكثر شيوعاً هي الشهرية والفصلية والسنوية.
- الفترة الزمنية - تمثل المدة التي تكون فيها موازنتك صالحة. تُراقب الموازنة استخدامك للموارد بفاعلية وتُنبهك فقط حال كونها سارية.
-
الإعلامات
- رسائل البريد الإلكتروني لجهة الاتصال - تتلقى عناوين البريد الإلكتروني تنبيهات عندما تتراكم تكاليف الميزانية وتتجاوز الحدود المحددة.
- أدوار جهات الاتصال - يتلقى جميع المستخدمين الذين لديهم دور Azure مطابق في النطاق المحدد تنبيهات بالبريد الإلكتروني باستخدام هذا الخيار. على سبيل المثال، يمكن لمالكي الاشتراكات تلقي تنبيه لموازنة تم إنشاؤها في نطاق الاشتراك.
- مجموعات جهات الاتصال - تستدعي الموازنة مجموعات الإجراءات المكونة عند تجاوز حد التنبيه.
- عوامل تصفية أبعاد التكلفة - يمكن إجراء نفس التصفية التي يمكنك إجراؤها في "تحليل التكلفة" أو "Query API" على موازنتك. استخدم عامل التصفية هذا لتقليل نطاق التكاليف التي تراقبها باستخدام الموازنة.
بعد تحديد خيارات إنشاء الموازنة التي تلبي احتياجاتك، أنشئ الموازنة باستخدام واجهة برمجة التطبيقات. ويساعد المثال أدناه في بدء التكوين الشائع للموازنة.
إنشاء ميزانية تمت تصفيتها إلى موارد وعلامات متعددة
عنوان URL للطلب: PUT https://management.azure.com/subscriptions/{SubscriptionId} /providers/Microsoft.Consumption/budgets/{BudgetName}/?api-version=2019-10-01
{
"eTag": "\"1d34d016a593709\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"timePeriod": {
"startDate": "2017-10-01T00:00:00Z",
"endDate": "2018-10-31T00:00:00Z"
},
"filter": {
"and": [
{
"dimensions": {
"name": "ResourceId",
"operator": "In",
"values": [
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}",
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}"
]
}
},
{
"tags": {
"name": "category",
"operator": "In",
"values": [
"Dev",
"Prod"
]
}
},
{
"tags": {
"name": "department",
"operator": "In",
"values": [
"engineering",
"sales"
]
}
}
]
},
"notifications": {
"Actual_GreaterThan_80_Percent": {
"enabled": true,
"operator": "GreaterThan",
"threshold": 80,
"contactEmails": [
"user1@contoso.com",
"user2@contoso.com"
],
"contactRoles": [
"Contributor",
"Reader"
],
"contactGroups": [
"/subscriptions/{subscriptionID}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
],
"thresholdType": "Actual"
}
}
}
}
تكوين التنسيق المستند إلى التكلفة لتنبيهات الموازنة
يمكنك تكوين الموازنات لبدء الإجراءات التلقائية باستخدام مجموعات عمل Azure. لمعرفة المزيد حول أتمتة الإجراءات باستخدام الميزانيات، راجع التنفيذ التلقائي مع الميزانيات.
زمن انتقال البيانات وحدود الأسعار
نوصي بعدم الاتصال بواجهات برمجة التطبيقات أكثر من مرة واحدة يومياً. وتُحدث بيانات إدارة التكلفة كل أربع ساعات عند تلقي بيانات استخدام جديدة من موفري موارد Azure. ولا يوفر الاتصال بشكل متكرر المزيد من البيانات. بل يؤدي إلى إنشاء حمل متزايد.
وحدات معالجة استعلام واجهة برمجة تطبيقات الاستعلام
بالإضافة إلى عمليات تحديد المعدل الحالية، تحد واجهة برمجة تطبيقات الاستعلام أيضا من المعالجة استنادا إلى تكلفة استدعاءات واجهة برمجة التطبيقات. يتم التعبير عن تكلفة استدعاء واجهة برمجة التطبيقات كوحدات معالجة استعلام (QPUs). QPU هي عملة أداء، مثل Cosmos DB RUs. إنها تجريد موارد النظام مثل وحدة المعالجة المركزية والذاكرة.
حساب QPU
حاليا، يتم خصم وحدة معالجة مركزية واحدة لمدة شهر واحد من البيانات التي تم الاستعلام عنها من الحصص النسبية المخصصة. قد يتغير هذا المنطق دون إشعار.
عوامل وحدة المعالجة السريعة
يؤثر العامل التالي على عدد وحدات QPUs المستهلكة بواسطة طلب واجهة برمجة التطبيقات.
- نطاق التاريخ، مع زيادة نطاق التاريخ في الطلب، يزداد عدد وحدات QPUs المستهلكة.
قد تتم إضافة عوامل QPU الأخرى دون إشعار.
حصص QPU النسبية
يتم تكوين الحصص النسبية التالية لكل مستأجر. يتم تقييد الطلبات عند استنفاد أي من الحصص النسبية التالية.
- 12 QPU لكل 10 ثوان
- 60 QPU لكل دقيقة واحدة
- 600 QPU لكل ساعة واحدة
ربما يتم تغيير الحصص حسب الحاجة ويمكن إضافة المزيد من الحصص النسبية.
رؤوس الردود
يمكنك فحص عناوين الاستجابة لتعقب عدد وحدات QPUs المستهلكة بواسطة طلب واجهة برمجة التطبيقات وعدد وحدات QPUs المتبقية.
x-ms-ratelimit-microsoft.costmanagement-qpu-retry-after
يشير إلى وقت التراجع بالثوان. عند تقييد طلب ب 429، ارجع للوقت المحدد في هذا العنوان قبل إعادة محاولة الطلب.
x-ms-ratelimit-microsoft.costmanagement-qpu-consumed
وحدات QPUs المستهلكة بواسطة استدعاء واجهة برمجة التطبيقات.
x-ms-ratelimit-microsoft.costmanagement-qpu-remaining
قائمة بالحصص النسبية المتبقية.