BatchPoolCreateOptions interface

الحزمة:

@azure-rest/batch

معلمات لإنشاء تجمع Azure Batch.

الخصائص

applicationPackageReferences	قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. عند إنشاء تجمع، يجب أن يكون معرف تطبيق الحزمة مؤهلا بالكامل (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين.
autoScaleEvaluationInterval	الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى والحد الأقصى للقيمة هو 5 دقائق و168 ساعة على التوالي. إذا قمت بتحديد قيمة أقل من 5 دقائق أو أكثر من 168 ساعة، فإن خدمة Batch ترجع خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).
autoScaleFormula	صيغة للعدد المطلوب من عقد الحوسبة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى false. مطلوب إذا تم تعيين enableAutoScale إلى true. يتم التحقق من صحة الصيغة قبل إنشاء التجمع. إذا كانت الصيغة غير صحيحة، ترفض خدمة Batch الطلب بمعلومات تفصيلية عن الخطأ. لمزيد من المعلومات حول تحديد هذه الصيغة، راجع "قياس عقد الحوسبة تلقائيا في تجمع Azure Batch" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).
displayName	اسم العرض للتجمع. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.
enableAutoScale	ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كانت خاطئة، يجب تحديد واحد على الأقل من targetDedicatedNodes و targetLowPriorityNodes. إذا كان صحيحا، تكون الخاصية autoScaleFormula مطلوبة ويغير التجمع الحجم تلقائيا وفقا للصيغة. القيمة الافتراضية خاطئة.
enableInterNodeCommunication	ما إذا كان التجمع يسمح بالاتصال المباشر بين عقد الحساب. يؤدي تمكين الاتصال بين العقد إلى الحد الأقصى لحجم التجمع بسبب قيود النشر على عقد الحوسبة في التجمع. قد يؤدي هذا إلى عدم وصول التجمع إلى الحجم المطلوب. القيمة الافتراضية خاطئة.
id	سلسلة تعرف التجمع بشكل فريد داخل الحساب. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي، ولا يمكن أن يحتوي على أكثر من 64 حرفا. المعرف هو الحفاظ على حالة الأحرف وغير حساس لحالة الأحرف (أي، قد لا يكون لديك معرفا تجمع داخل حساب يختلفان فقط حسب الحالة).
metadata	قائمة أزواج الاسم والقيمة المقترنة بالتجمع كبيانات تعريف. لا تعين خدمة Batch أي معنى لبيانات التعريف؛ هو فقط لاستخدام التعليمات البرمجية للمستخدم.
mountConfiguration	تحميل التخزين باستخدام نظام ملفات محدد طوال مدة بقاء التجمع. قم بتحميل التخزين باستخدام Azure fileshare أو NFS أو CIFS أو نظام الملفات المستند إلى Blobfuse.
networkConfiguration	تكوين الشبكة للتجمع.
resizeTimeout	مهلة تخصيص عقد الحوسبة إلى التجمع. تنطبق هذه المهلة فقط على التحجيم اليدوي؛ ليس له أي تأثير عند تعيين enableAutoScale إلى true. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى للقيمة هو 5 دقائق. إذا قمت بتحديد قيمة أقل من 5 دقائق، فإن خدمة Batch ترجع خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).
startTask	مهمة محددة للتشغيل على كل عقدة حساب أثناء انضمامها إلى التجمع. يتم تشغيل المهمة عند إضافة عقدة الحساب إلى التجمع أو عند إعادة تشغيل عقدة الحساب.
targetDedicatedNodes	العدد المطلوب من عقد الحوسبة المخصصة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.
targetLowPriorityNodes	العدد المطلوب من Spot/Low-priority Compute Nodes في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى true. إذا تم تعيين enableAutoScale إلى false، فيجب عليك تعيين إما targetDedicatedNodes أو targetLowPriorityNodes أو كليهما.
taskSchedulingPolicy	كيفية توزيع المهام عبر عقد الحوسبة في تجمع. إذا لم يتم تحديده، يكون الافتراضي هو spread.
taskSlotsPerNode	عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256.
upgradePolicy	نهج الترقية للتجمع. يصف نهج الترقية - تلقائي أو يدوي أو متجدد.
userAccounts	قائمة حسابات المستخدمين التي سيتم إنشاؤها على كل عقدة حساب في التجمع.
virtualMachineConfiguration	تكوين الجهاز الظاهري للتجمع. يجب تحديد هذه الخاصية.
vmSize	حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول أحجام الأجهزة الظاهرية المتوفرة للتجمعات باستخدام الصور من سوق الأجهزة الظاهرية (التجمعات التي تم إنشاؤها باستخدام virtualMachineConfiguration)، راجع أحجام الأجهزة الظاهرية في Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). تدعم Batch جميع أحجام أجهزة Azure الظاهرية باستثناء STANDARD_A0 وتلك التي بها تخزين متميز (STANDARD_GS STANDARD_DS وسلسلة STANDARD_DSV2).

تفاصيل الخاصية

applicationPackageReferences

قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. عند إنشاء تجمع، يجب أن يكون معرف تطبيق الحزمة مؤهلا بالكامل (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين.

applicationPackageReferences?: BatchApplicationPackageReference[]

قيمة الخاصية

BatchApplicationPackageReference[]

autoScaleEvaluationInterval

الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى والحد الأقصى للقيمة هو 5 دقائق و168 ساعة على التوالي. إذا قمت بتحديد قيمة أقل من 5 دقائق أو أكثر من 168 ساعة، فإن خدمة Batch ترجع خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).

autoScaleEvaluationInterval?: string

قيمة الخاصية

string

autoScaleFormula

صيغة للعدد المطلوب من عقد الحوسبة في التجمع. يجب عدم تحديد هذه الخاصية إذا تم تعيين enableAutoScale إلى false. مطلوب إذا تم تعيين enableAutoScale إلى true. يتم التحقق من صحة الصيغة قبل إنشاء التجمع. إذا كانت الصيغة غير صحيحة، ترفض خدمة Batch الطلب بمعلومات تفصيلية عن الخطأ. لمزيد من المعلومات حول تحديد هذه الصيغة، راجع "قياس عقد الحوسبة تلقائيا في تجمع Azure Batch" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).

autoScaleFormula?: string

قيمة الخاصية

string

displayName

اسم العرض للتجمع. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.

displayName?: string

قيمة الخاصية

string

enableAutoScale

ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كانت خاطئة، يجب تحديد واحد على الأقل من targetDedicatedNodes و targetLowPriorityNodes. إذا كان صحيحا، تكون الخاصية autoScaleFormula مطلوبة ويغير التجمع الحجم تلقائيا وفقا للصيغة. القيمة الافتراضية خاطئة.

enableAutoScale?: boolean

قيمة الخاصية

boolean

enableInterNodeCommunication

ما إذا كان التجمع يسمح بالاتصال المباشر بين عقد الحساب. يؤدي تمكين الاتصال بين العقد إلى الحد الأقصى لحجم التجمع بسبب قيود النشر على عقد الحوسبة في التجمع. قد يؤدي هذا إلى عدم وصول التجمع إلى الحجم المطلوب. القيمة الافتراضية خاطئة.

enableInterNodeCommunication?: boolean

قيمة الخاصية

boolean

id

سلسلة تعرف التجمع بشكل فريد داخل الحساب. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي، ولا يمكن أن يحتوي على أكثر من 64 حرفا. المعرف هو الحفاظ على حالة الأحرف وغير حساس لحالة الأحرف (أي، قد لا يكون لديك معرفا تجمع داخل حساب يختلفان فقط حسب الحالة).

id: string

قيمة الخاصية

string

metadata

قائمة أزواج الاسم والقيمة المقترنة بالتجمع كبيانات تعريف. لا تعين خدمة Batch أي معنى لبيانات التعريف؛ هو فقط لاستخدام التعليمات البرمجية للمستخدم.

metadata?: BatchMetadataItem[]

قيمة الخاصية

BatchMetadataItem[]

mountConfiguration

تحميل التخزين باستخدام نظام ملفات محدد طوال مدة بقاء التجمع. قم بتحميل التخزين باستخدام Azure fileshare أو NFS أو CIFS أو نظام الملفات المستند إلى Blobfuse.

mountConfiguration?: MountConfiguration[]

قيمة الخاصية

MountConfiguration[]

networkConfiguration

تكوين الشبكة للتجمع.

networkConfiguration?: NetworkConfiguration

قيمة الخاصية

NetworkConfiguration

resizeTimeout

مهلة تخصيص عقد الحوسبة إلى التجمع. تنطبق هذه المهلة فقط على التحجيم اليدوي؛ ليس له أي تأثير عند تعيين enableAutoScale إلى true. القيمة الافتراضية هي 15 دقيقة. الحد الأدنى للقيمة هو 5 دقائق. إذا قمت بتحديد قيمة أقل من 5 دقائق، فإن خدمة Batch ترجع خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).

resizeTimeout?: string

قيمة الخاصية

string

startTask

مهمة محددة للتشغيل على كل عقدة حساب أثناء انضمامها إلى التجمع. يتم تشغيل المهمة عند إضافة عقدة الحساب إلى التجمع أو عند إعادة تشغيل عقدة الحساب.

startTask?: BatchStartTask

قيمة الخاصية

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

قيمة الخاصية

BatchTaskSchedulingPolicy

taskSlotsPerNode

عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256.

taskSlotsPerNode?: number

قيمة الخاصية

number

upgradePolicy

نهج الترقية للتجمع. يصف نهج الترقية - تلقائي أو يدوي أو متجدد.

upgradePolicy?: UpgradePolicy

قيمة الخاصية

UpgradePolicy

userAccounts

قائمة حسابات المستخدمين التي سيتم إنشاؤها على كل عقدة حساب في التجمع.

userAccounts?: UserAccount[]

قيمة الخاصية

UserAccount[]

virtualMachineConfiguration

تكوين الجهاز الظاهري للتجمع. يجب تحديد هذه الخاصية.

virtualMachineConfiguration?: VirtualMachineConfiguration

قيمة الخاصية

VirtualMachineConfiguration

vmSize

حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول أحجام الأجهزة الظاهرية المتوفرة للتجمعات باستخدام الصور من سوق الأجهزة الظاهرية (التجمعات التي تم إنشاؤها باستخدام virtualMachineConfiguration)، راجع أحجام الأجهزة الظاهرية في Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). تدعم Batch جميع أحجام أجهزة Azure الظاهرية باستثناء STANDARD_A0 وتلك التي بها تخزين متميز (STANDARD_GS STANDARD_DS وسلسلة STANDARD_DSV2).

vmSize: string

قيمة الخاصية

string