BatchPoolSpecification interface
مواصفات إنشاء تجمع جديد.
الخصائص
| application |
قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. عند إنشاء تجمع، يجب أن يكون معرف تطبيق الحزمة مؤهلا بالكامل (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين. |
| auto |
الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى والحد الأقصى للقيمة هو 5 دقائق و168 ساعة على التوالي. إذا قمت بتحديد قيمة أقل من 5 دقائق أو أكثر من 168 ساعة، فإن خدمة Batch ترفض الطلب مع خطأ قيمة خاصية غير صالح؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح). |
| auto |
صيغة العدد المطلوب من عقد الحوسبة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى false. مطلوب إذا تم تعيين enableAutoScale إلى true. يتم التحقق من صحة الصيغة قبل إنشاء التجمع. إذا كانت الصيغة غير صحيحة، ترفض خدمة Batch الطلب بمعلومات تفصيلية عن الخطأ. |
| display |
اسم العرض للتجمع. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى. |
| enable |
ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كانت خاطئة، يجب تحديد واحد على الأقل من targetDedicatedNodes و targetLowPriorityNodes. إذا كان صحيحا، مطلوب عنصر autoScaleFormula. يتم تغيير حجم التجمع تلقائيا وفقا للصيغة. القيمة الافتراضية خاطئة. |
| enable |
ما إذا كان التجمع يسمح بالاتصال المباشر بين عقد الحساب. يؤدي تمكين الاتصال بين العقد إلى الحد الأقصى لحجم التجمع بسبب قيود النشر على عقد الحوسبة في التجمع. قد يؤدي هذا إلى عدم وصول التجمع إلى الحجم المطلوب. القيمة الافتراضية خاطئة. |
| metadata | قائمة أزواج الاسم والقيمة المقترنة بالتجمع كبيانات تعريف. لا تعين خدمة Batch أي معنى لبيانات التعريف؛ هو فقط لاستخدام التعليمات البرمجية للمستخدم. |
| mount |
قائمة أنظمة الملفات لتحميلها على كل عقدة في التجمع. يدعم هذا Azure Files وNFS وCSIFS/SMB وBlobfuse. |
| network |
تكوين الشبكة للتجمع. |
| resize |
مهلة تخصيص عقد الحوسبة إلى التجمع. تنطبق هذه المهلة فقط على التحجيم اليدوي؛ ليس له أي تأثير عند تعيين enableAutoScale إلى true. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى للقيمة هو 5 دقائق. إذا قمت بتحديد قيمة أقل من 5 دقائق، فإن خدمة Batch ترفض الطلب بخطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح). |
| start |
مهمة لتشغيلها على كل عقدة حساب أثناء انضمامها إلى التجمع. يتم تشغيل المهمة عند إضافة عقدة الحساب إلى التجمع أو عند إعادة تشغيل عقدة الحساب. |
| target |
العدد المطلوب من عقد الحوسبة المخصصة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما. |
| target |
العدد المطلوب من Spot/Low-priority Compute Nodes في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما. |
| task |
كيفية توزيع المهام عبر عقد الحوسبة في تجمع. إذا لم يتم تحديده، يكون الافتراضي هو spread. |
| task |
عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256. |
| upgrade |
نهج الترقية للتجمع. يصف نهج الترقية - تلقائي أو يدوي أو متجدد. |
| user |
قائمة حسابات المستخدمين التي سيتم إنشاؤها على كل عقدة حساب في التجمع. |
| virtual |
تكوين الجهاز الظاهري للتجمع. يجب تحديد هذه الخاصية. |
| vm |
حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول الأحجام المتوفرة للأجهزة الظاهرية في التجمعات، راجع اختيار حجم الجهاز الظاهري لحساب العقد في تجمع Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes). |
تفاصيل الخاصية
applicationPackageReferences
قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. عند إنشاء تجمع، يجب أن يكون معرف تطبيق الحزمة مؤهلا بالكامل (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين.
applicationPackageReferences?: BatchApplicationPackageReference[]
قيمة الخاصية
autoScaleEvaluationInterval
الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى والحد الأقصى للقيمة هو 5 دقائق و168 ساعة على التوالي. إذا قمت بتحديد قيمة أقل من 5 دقائق أو أكثر من 168 ساعة، فإن خدمة Batch ترفض الطلب مع خطأ قيمة خاصية غير صالح؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).
autoScaleEvaluationInterval?: string
قيمة الخاصية
string
autoScaleFormula
صيغة العدد المطلوب من عقد الحوسبة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى false. مطلوب إذا تم تعيين enableAutoScale إلى true. يتم التحقق من صحة الصيغة قبل إنشاء التجمع. إذا كانت الصيغة غير صحيحة، ترفض خدمة Batch الطلب بمعلومات تفصيلية عن الخطأ.
autoScaleFormula?: string
قيمة الخاصية
string
displayName
اسم العرض للتجمع. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.
displayName?: string
قيمة الخاصية
string
enableAutoScale
ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كانت خاطئة، يجب تحديد واحد على الأقل من targetDedicatedNodes و targetLowPriorityNodes. إذا كان صحيحا، مطلوب عنصر autoScaleFormula. يتم تغيير حجم التجمع تلقائيا وفقا للصيغة. القيمة الافتراضية خاطئة.
enableAutoScale?: boolean
قيمة الخاصية
boolean
enableInterNodeCommunication
ما إذا كان التجمع يسمح بالاتصال المباشر بين عقد الحساب. يؤدي تمكين الاتصال بين العقد إلى الحد الأقصى لحجم التجمع بسبب قيود النشر على عقد الحوسبة في التجمع. قد يؤدي هذا إلى عدم وصول التجمع إلى الحجم المطلوب. القيمة الافتراضية خاطئة.
enableInterNodeCommunication?: boolean
قيمة الخاصية
boolean
metadata
قائمة أزواج الاسم والقيمة المقترنة بالتجمع كبيانات تعريف. لا تعين خدمة Batch أي معنى لبيانات التعريف؛ هو فقط لاستخدام التعليمات البرمجية للمستخدم.
metadata?: BatchMetadataItem[]
قيمة الخاصية
mountConfiguration
قائمة أنظمة الملفات لتحميلها على كل عقدة في التجمع. يدعم هذا Azure Files وNFS وCSIFS/SMB وBlobfuse.
mountConfiguration?: MountConfiguration[]
قيمة الخاصية
networkConfiguration
resizeTimeout
مهلة تخصيص عقد الحوسبة إلى التجمع. تنطبق هذه المهلة فقط على التحجيم اليدوي؛ ليس له أي تأثير عند تعيين enableAutoScale إلى true. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى للقيمة هو 5 دقائق. إذا قمت بتحديد قيمة أقل من 5 دقائق، فإن خدمة Batch ترفض الطلب بخطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).
resizeTimeout?: string
قيمة الخاصية
string
startTask
مهمة لتشغيلها على كل عقدة حساب أثناء انضمامها إلى التجمع. يتم تشغيل المهمة عند إضافة عقدة الحساب إلى التجمع أو عند إعادة تشغيل عقدة الحساب.
startTask?: BatchStartTask
قيمة الخاصية
targetDedicatedNodes
العدد المطلوب من عقد الحوسبة المخصصة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.
targetDedicatedNodes?: number
قيمة الخاصية
number
targetLowPriorityNodes
العدد المطلوب من Spot/Low-priority Compute Nodes في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.
targetLowPriorityNodes?: number
قيمة الخاصية
number
taskSchedulingPolicy
كيفية توزيع المهام عبر عقد الحوسبة في تجمع. إذا لم يتم تحديده، يكون الافتراضي هو spread.
taskSchedulingPolicy?: BatchTaskSchedulingPolicy
قيمة الخاصية
taskSlotsPerNode
عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256.
taskSlotsPerNode?: number
قيمة الخاصية
number
upgradePolicy
نهج الترقية للتجمع. يصف نهج الترقية - تلقائي أو يدوي أو متجدد.
upgradePolicy?: UpgradePolicy
قيمة الخاصية
userAccounts
قائمة حسابات المستخدمين التي سيتم إنشاؤها على كل عقدة حساب في التجمع.
userAccounts?: UserAccount[]
قيمة الخاصية
virtualMachineConfiguration
تكوين الجهاز الظاهري للتجمع. يجب تحديد هذه الخاصية.
virtualMachineConfiguration?: VirtualMachineConfiguration
قيمة الخاصية
vmSize
حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول الأحجام المتوفرة للأجهزة الظاهرية في التجمعات، راجع اختيار حجم الجهاز الظاهري لحساب العقد في تجمع Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).
vmSize: string
قيمة الخاصية
string