PoolSpecification interface
واجهة تمثل PoolSpecification.
الخصائص
| application |
قائمة تراخيص التطبيق التي ستتاحها خدمة Batch على كل عقدة حساب في التجمع. يجب أن تكون قائمة تراخيص التطبيقات مجموعة فرعية من تراخيص تطبيق خدمة Batch المتوفرة. إذا تم طلب ترخيص غير مدعوم، فسيفشل إنشاء التجمع. التراخيص المسموح بها المتوفرة على التجمع هي "maya" و"vray" و"3dsmax" و"arnold". يتم تطبيق رسوم إضافية على كل ترخيص تطبيق تمت إضافته إلى التجمع. |
| application |
قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين. |
| auto |
الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى والحد الأقصى للقيمة هو 5 دقائق و168 ساعة على التوالي. إذا قمت بتحديد قيمة أقل من 5 دقائق أو أكثر من 168 ساعة، فإن خدمة Batch ترفض الطلب مع خطأ قيمة خاصية غير صالح؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح). |
| auto |
صيغة العدد المطلوب من عقد الحوسبة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى false. مطلوب إذا تم تعيين enableAutoScale إلى true. يتم التحقق من صحة الصيغة قبل إنشاء التجمع. إذا كانت الصيغة غير صحيحة، ترفض خدمة Batch الطلب بمعلومات تفصيلية عن الخطأ. |
| certificate |
قائمة بالشهادات التي سيتم تثبيتها على كل عقدة حساب في التجمع. بالنسبة إلى Windows Nodes، تقوم خدمة Batch بتثبيت الشهادات إلى مخزن الشهادات والموقع المحددين. بالنسبة لعقد حساب Linux، يتم تخزين الشهادات في دليل داخل دليل عمل المهمة ويتم توفير متغير بيئة AZ_BATCH_CERTIFICATES_DIR للمهمة للاستعلام عن هذا الموقع. بالنسبة للشهادات التي لها رؤية "remoteUser"، يتم إنشاء دليل "certs" في الدليل الرئيسي للمستخدم (على سبيل المثال، /home/{user-name}/certs) ويتم وضع الشهادات في هذا الدليل. |
| cloud |
تكوين الخدمة السحابية للتجمع. يجب تحديد هذه الخاصية إذا كان يجب إنشاء التجمع باستخدام أجهزة Azure PaaS الظاهرية. هذه الخاصية و virtualMachineConfiguration خاصان بشكل متبادل ويجب تحديد إحدى الخصائص. إذا لم يتم تحديد أي منهما، فترجع خدمة Batch خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح). لا يمكن تحديد هذه الخاصية إذا تم إنشاء حساب الدفعة مع تعيين الخاصية poolAllocationMode الخاصة به إلى "UserSubscription". |
| display |
اسم العرض للتجمع. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى. |
| enable |
ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كانت خاطئة، يجب تحديد واحد على الأقل من targetDedicateNodes و 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 |
العدد المطلوب من عقد الحوسبة ذات الأولوية المنخفضة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما. |
| task |
كيفية توزيع المهام عبر عقد الحوسبة في تجمع. إذا لم يتم تحديده، يكون الافتراضي هو spread. |
| task |
عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256. |
| user |
قائمة حسابات المستخدمين التي سيتم إنشاؤها على كل عقدة حساب في التجمع. |
| virtual |
تكوين الجهاز الظاهري للتجمع. يجب تحديد هذه الخاصية إذا كان يجب إنشاء التجمع باستخدام أجهزة Azure IaaS الظاهرية. هذه الخاصية و cloudServiceConfiguration حصريان بشكل متبادل ويجب تحديد إحدى الخصائص. إذا لم يتم تحديد أي منهما، فترجع خدمة Batch خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح). |
| vm |
حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول الأحجام المتوفرة للأجهزة الظاهرية في التجمعات، راجع اختيار حجم الجهاز الظاهري لحساب العقد في تجمع Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes). |
تفاصيل الخاصية
applicationLicenses
قائمة تراخيص التطبيق التي ستتاحها خدمة Batch على كل عقدة حساب في التجمع. يجب أن تكون قائمة تراخيص التطبيقات مجموعة فرعية من تراخيص تطبيق خدمة Batch المتوفرة. إذا تم طلب ترخيص غير مدعوم، فسيفشل إنشاء التجمع. التراخيص المسموح بها المتوفرة على التجمع هي "maya" و"vray" و"3dsmax" و"arnold". يتم تطبيق رسوم إضافية على كل ترخيص تطبيق تمت إضافته إلى التجمع.
applicationLicenses?: string[]
قيمة الخاصية
string[]
applicationPackageReferences
قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين.
applicationPackageReferences?: ApplicationPackageReference[]
قيمة الخاصية
autoScaleEvaluationInterval
الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى والحد الأقصى للقيمة هو 5 دقائق و168 ساعة على التوالي. إذا قمت بتحديد قيمة أقل من 5 دقائق أو أكثر من 168 ساعة، فإن خدمة Batch ترفض الطلب مع خطأ قيمة خاصية غير صالح؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).
autoScaleEvaluationInterval?: string
قيمة الخاصية
string
autoScaleFormula
صيغة العدد المطلوب من عقد الحوسبة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى false. مطلوب إذا تم تعيين enableAutoScale إلى true. يتم التحقق من صحة الصيغة قبل إنشاء التجمع. إذا كانت الصيغة غير صحيحة، ترفض خدمة Batch الطلب بمعلومات تفصيلية عن الخطأ.
autoScaleFormula?: string
قيمة الخاصية
string
certificateReferences
قائمة بالشهادات التي سيتم تثبيتها على كل عقدة حساب في التجمع. بالنسبة إلى Windows Nodes، تقوم خدمة Batch بتثبيت الشهادات إلى مخزن الشهادات والموقع المحددين. بالنسبة لعقد حساب Linux، يتم تخزين الشهادات في دليل داخل دليل عمل المهمة ويتم توفير متغير بيئة AZ_BATCH_CERTIFICATES_DIR للمهمة للاستعلام عن هذا الموقع. بالنسبة للشهادات التي لها رؤية "remoteUser"، يتم إنشاء دليل "certs" في الدليل الرئيسي للمستخدم (على سبيل المثال، /home/{user-name}/certs) ويتم وضع الشهادات في هذا الدليل.
certificateReferences?: CertificateReference[]
قيمة الخاصية
cloudServiceConfiguration
تكوين الخدمة السحابية للتجمع. يجب تحديد هذه الخاصية إذا كان يجب إنشاء التجمع باستخدام أجهزة Azure PaaS الظاهرية. هذه الخاصية و virtualMachineConfiguration خاصان بشكل متبادل ويجب تحديد إحدى الخصائص. إذا لم يتم تحديد أي منهما، فترجع خدمة Batch خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح). لا يمكن تحديد هذه الخاصية إذا تم إنشاء حساب الدفعة مع تعيين الخاصية poolAllocationMode الخاصة به إلى "UserSubscription".
cloudServiceConfiguration?: CloudServiceConfiguration
قيمة الخاصية
displayName
اسم العرض للتجمع. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.
displayName?: string
قيمة الخاصية
string
enableAutoScale
ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كانت خاطئة، يجب تحديد واحد على الأقل من targetDedicateNodes و targetLowPriorityNodes. إذا كان صحيحا، مطلوب عنصر autoScaleFormula. يتم تغيير حجم التجمع تلقائيا وفقا للصيغة. القيمة الافتراضية خاطئة.
enableAutoScale?: boolean
قيمة الخاصية
boolean
enableInterNodeCommunication
ما إذا كان التجمع يسمح بالاتصال المباشر بين عقد الحساب. يؤدي تمكين الاتصال بين العقد إلى الحد الأقصى لحجم التجمع بسبب قيود النشر على عقد الحوسبة في التجمع. قد يؤدي هذا إلى عدم وصول التجمع إلى الحجم المطلوب. القيمة الافتراضية خاطئة.
enableInterNodeCommunication?: boolean
قيمة الخاصية
boolean
metadata
قائمة أزواج الاسم والقيمة المقترنة بالتجمع كبيانات تعريف. لا تعين خدمة Batch أي معنى لبيانات التعريف؛ هو فقط لاستخدام التعليمات البرمجية للمستخدم.
metadata?: MetadataItem[]
قيمة الخاصية
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?: StartTask
قيمة الخاصية
targetDedicatedNodes
العدد المطلوب من عقد الحوسبة المخصصة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.
targetDedicatedNodes?: number
قيمة الخاصية
number
targetLowPriorityNodes
العدد المطلوب من عقد الحوسبة ذات الأولوية المنخفضة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.
targetLowPriorityNodes?: number
قيمة الخاصية
number
taskSchedulingPolicy
كيفية توزيع المهام عبر عقد الحوسبة في تجمع. إذا لم يتم تحديده، يكون الافتراضي هو spread.
taskSchedulingPolicy?: TaskSchedulingPolicy
قيمة الخاصية
taskSlotsPerNode
عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256.
taskSlotsPerNode?: number
قيمة الخاصية
number
userAccounts
قائمة حسابات المستخدمين التي سيتم إنشاؤها على كل عقدة حساب في التجمع.
userAccounts?: UserAccount[]
قيمة الخاصية
virtualMachineConfiguration
تكوين الجهاز الظاهري للتجمع. يجب تحديد هذه الخاصية إذا كان يجب إنشاء التجمع باستخدام أجهزة Azure IaaS الظاهرية. هذه الخاصية و cloudServiceConfiguration حصريان بشكل متبادل ويجب تحديد إحدى الخصائص. إذا لم يتم تحديد أي منهما، فترجع خدمة Batch خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).
virtualMachineConfiguration?: VirtualMachineConfiguration
قيمة الخاصية
vmSize
حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول الأحجام المتوفرة للأجهزة الظاهرية في التجمعات، راجع اختيار حجم الجهاز الظاهري لحساب العقد في تجمع Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).
vmSize: string
قيمة الخاصية
string