CloudPool interface

الحزمة:

@azure/batch

واجهة تمثل CloudPool.

الخصائص

allocationState	ما إذا كان يتم تغيير حجم التجمع. تتضمن القيم المحتملة: "ثابت"، "تغيير الحجم"، "إيقاف"
allocationStateTransitionTime	الوقت الذي أدخل فيه التجمع حالة التخصيص الحالية الخاصة به.
applicationLicenses	قائمة تراخيص التطبيق التي ستتاحها خدمة Batch على كل عقدة حساب في التجمع. يجب أن تكون قائمة تراخيص التطبيقات مجموعة فرعية من تراخيص تطبيق خدمة Batch المتوفرة. إذا تم طلب ترخيص غير مدعوم، فسيفشل إنشاء التجمع.
applicationPackageReferences	قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين.
autoScaleEvaluationInterval	الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. يتم تعيين هذه الخاصية فقط إذا تم تغيير حجم التجمع تلقائيا، أي enableAutoScale صحيح.
autoScaleFormula	صيغة للعدد المطلوب من عقد الحوسبة في التجمع. يتم تعيين هذه الخاصية فقط إذا تم تغيير حجم التجمع تلقائيا، أي enableAutoScale صحيح.
autoScaleRun	النتائج والأخطاء من التنفيذ الأخير لصيغة التحجيم التلقائي. يتم تعيين هذه الخاصية فقط إذا تم تغيير حجم التجمع تلقائيا، أي enableAutoScale صحيح.
certificateReferences	قائمة الشهادات التي سيتم تثبيتها على كل عقدة حساب في التجمع. بالنسبة إلى Windows Nodes، تقوم خدمة Batch بتثبيت الشهادات إلى مخزن الشهادات والموقع المحددين. بالنسبة لعقد حساب Linux، يتم تخزين الشهادات في دليل داخل دليل عمل المهمة ويتم توفير متغير بيئة AZ_BATCH_CERTIFICATES_DIR للمهمة للاستعلام عن هذا الموقع. بالنسبة للشهادات التي لها رؤية "remoteUser"، يتم إنشاء دليل "certs" في الدليل الرئيسي للمستخدم (على سبيل المثال، /home/{user-name}/certs) ويتم وضع الشهادات في هذا الدليل.
cloudServiceConfiguration	تكوين الخدمة السحابية للتجمع. هذه الخاصية و virtualMachineConfiguration خاصان بشكل متبادل ويجب تحديد إحدى الخصائص. لا يمكن تحديد هذه الخاصية إذا تم إنشاء حساب الدفعة مع تعيين الخاصية poolAllocationMode الخاصة به إلى "UserSubscription".
creationTime	وقت إنشاء التجمع.
currentDedicatedNodes	عدد عقد الحوسبة المخصصة حاليا في التجمع.
currentLowPriorityNodes	عدد عقد الحوسبة ذات الأولوية المنخفضة حاليا في التجمع. يتم تضمين عقد الحوسبة ذات الأولوية المنخفضة التي تم استباقها في هذا العدد.
displayName	اسم العرض للتجمع. لا يجب أن يكون اسم العرض فريدا ويمكن أن يحتوي على أي أحرف Unicode يصل طولها إلى 1024 كحد أقصى.
enableAutoScale	ما إذا كان يجب ضبط حجم التجمع تلقائيا بمرور الوقت. إذا كانت خاطئة، يجب تحديد واحد على الأقل من targetDedicateNodes و targetLowPriorityNodes. إذا كان صحيحا، تكون الخاصية autoScaleFormula مطلوبة ويغير التجمع الحجم تلقائيا وفقا للصيغة. القيمة الافتراضية خاطئة.
enableInterNodeCommunication	ما إذا كان التجمع يسمح بالاتصال المباشر بين عقد الحساب. وهذا يفرض قيودا على العقد الحسابية التي يمكن تعيينها إلى التجمع. يمكن أن يقلل تحديد هذه القيمة من فرصة العدد المطلوب من عقد الحوسبة التي سيتم تخصيصها في التجمع.
eTag	ETag للتجمع. هذه سلسلة مبهمة. يمكنك استخدامه للكشف عما إذا كان التجمع قد تغير بين الطلبات. على وجه الخصوص، يمكنك تمرير ETag عند تحديث تجمع لتحديد أن التغييرات الخاصة بك يجب أن تصبح سارية المفعول فقط إذا لم يقم أي شخص آخر بتعديل التجمع في هذه الأثناء.
id	سلسلة تعرف التجمع بشكل فريد داخل الحساب. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي، ولا يمكن أن يحتوي على أكثر من 64 حرفا. المعرف هو الحفاظ على حالة الأحرف وغير حساس لحالة الأحرف (أي، قد لا يكون لديك معرفان داخل حساب يختلفان فقط حسب الحالة).
lastModified	آخر وقت تم تعديله من التجمع. هذه هي المرة الأخيرة التي تتغير فيها بيانات مستوى التجمع، مثل targetDedicatedNodes أو enableAutoscale settings. لا يتم احتساب التغييرات على مستوى العقدة مثل حالة تغيير عقدة الحساب.
metadata	قائمة أزواج الاسم والقيمة المقترنة بالتجمع كبيانات تعريف.
mountConfiguration	قائمة أنظمة الملفات لتحميلها على كل عقدة في التجمع. يدعم هذا Azure Files وNFS وCSIFS/SMB وBlobfuse.
networkConfiguration	تكوين الشبكة للتجمع.
resizeErrors	قائمة بالأخطاء التي تمت مواجهتها أثناء إجراء آخر تغيير حجم على التجمع. يتم تعيين هذه الخاصية فقط إذا حدث خطأ واحد أو أكثر أثناء تغيير حجم التجمع الأخير، وعندما يكون Pool allocationState ثابتا فقط.
resizeTimeout	مهلة تخصيص عقد الحوسبة إلى التجمع. هذه هي المهلة لأحدث عملية تغيير حجم. (يتم احتساب الحجم الأولي عند إنشاء التجمع كتحجيم.) القيمة الافتراضية هي 15 دقيقة.
startTask	مهمة محددة للتشغيل على كل عقدة حساب أثناء انضمامها إلى التجمع.
state	الحالة الحالية للتجمع. تتضمن القيم المحتملة: "نشط" و"حذف"
stateTransitionTime	الوقت الذي أدخل فيه التجمع حالته الحالية.
stats	إحصائيات الاستخدام واستخدام الموارد طوال مدة بقاء التجمع. يتم ملء هذه الخاصية فقط إذا تم استرداد CloudPool بجملة توسيع بما في ذلك سمة "الإحصائيات"؛ وإلا فهي فارغة. وقد لا تكون الإحصاءات متاحة على الفور. تقوم خدمة Batch بإجراء مجموعة دورية من الإحصائيات. التأخير النموذجي حوالي 30 دقيقة.
targetDedicatedNodes	العدد المطلوب من عقد الحوسبة المخصصة في التجمع.
targetLowPriorityNodes	العدد المطلوب من عقد الحوسبة ذات الأولوية المنخفضة في التجمع.
taskSchedulingPolicy	كيفية توزيع المهام عبر عقد الحوسبة في تجمع. إذا لم يتم تحديده، يكون الافتراضي هو spread.
taskSlotsPerNode	عدد فتحات المهام التي يمكن استخدامها لتشغيل المهام المتزامنة على عقدة حساب واحدة في التجمع. القيمة الافتراضية هي 1. القيمة القصوى هي أصغر من 4 أضعاف عدد الذاكرات الأساسية ل vmSize للتجمع أو 256.
url	عنوان URL الخاص بالتجمع.
userAccounts	قائمة حسابات المستخدمين التي سيتم إنشاؤها على كل عقدة حساب في التجمع.
virtualMachineConfiguration	تكوين الجهاز الظاهري للتجمع. هذه الخاصية و cloudServiceConfiguration حصريان بشكل متبادل ويجب تحديد إحدى الخصائص.
vmSize	حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول الأحجام المتوفرة للأجهزة الظاهرية في التجمعات، راجع اختيار حجم الجهاز الظاهري لحساب العقد في تجمع Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

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

allocationState

ما إذا كان يتم تغيير حجم التجمع. تتضمن القيم المحتملة: "ثابت"، "تغيير الحجم"، "إيقاف"

allocationState?: AllocationState

قيمة الخاصية

AllocationState

allocationStateTransitionTime

الوقت الذي أدخل فيه التجمع حالة التخصيص الحالية الخاصة به.

allocationStateTransitionTime?: Date

قيمة الخاصية

Date

applicationLicenses

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

applicationLicenses?: string[]

قيمة الخاصية

string[]

applicationPackageReferences

قائمة الحزم التي سيتم تثبيتها على كل عقدة حساب في التجمع. تؤثر التغييرات على مراجع الحزمة على جميع العقد الجديدة التي تنضم إلى التجمع، ولكن لا تؤثر على حساب العقد الموجودة بالفعل في التجمع حتى يتم إعادة تمهيدها أو إعادة تصورها. هناك بحد أقصى 10 مراجع حزمة على أي تجمع معين.

applicationPackageReferences?: ApplicationPackageReference[]

قيمة الخاصية

ApplicationPackageReference[]

autoScaleEvaluationInterval

الفاصل الزمني لضبط حجم التجمع تلقائيا وفقا لصيغة التحجيم التلقائي. يتم تعيين هذه الخاصية فقط إذا تم تغيير حجم التجمع تلقائيا، أي enableAutoScale صحيح.

autoScaleEvaluationInterval?: string

قيمة الخاصية

string

autoScaleFormula

صيغة للعدد المطلوب من عقد الحوسبة في التجمع. يتم تعيين هذه الخاصية فقط إذا تم تغيير حجم التجمع تلقائيا، أي enableAutoScale صحيح.

autoScaleFormula?: string

قيمة الخاصية

string

autoScaleRun

النتائج والأخطاء من التنفيذ الأخير لصيغة التحجيم التلقائي. يتم تعيين هذه الخاصية فقط إذا تم تغيير حجم التجمع تلقائيا، أي enableAutoScale صحيح.

autoScaleRun?: AutoScaleRun

قيمة الخاصية

AutoScaleRun

certificateReferences

قائمة الشهادات التي سيتم تثبيتها على كل عقدة حساب في التجمع. بالنسبة إلى Windows Nodes، تقوم خدمة Batch بتثبيت الشهادات إلى مخزن الشهادات والموقع المحددين. بالنسبة لعقد حساب Linux، يتم تخزين الشهادات في دليل داخل دليل عمل المهمة ويتم توفير متغير بيئة AZ_BATCH_CERTIFICATES_DIR للمهمة للاستعلام عن هذا الموقع. بالنسبة للشهادات التي لها رؤية "remoteUser"، يتم إنشاء دليل "certs" في الدليل الرئيسي للمستخدم (على سبيل المثال، /home/{user-name}/certs) ويتم وضع الشهادات في هذا الدليل.

certificateReferences?: CertificateReference[]

قيمة الخاصية

CertificateReference[]

cloudServiceConfiguration

تكوين الخدمة السحابية للتجمع. هذه الخاصية و virtualMachineConfiguration خاصان بشكل متبادل ويجب تحديد إحدى الخصائص. لا يمكن تحديد هذه الخاصية إذا تم إنشاء حساب الدفعة مع تعيين الخاصية poolAllocationMode الخاصة به إلى "UserSubscription".

cloudServiceConfiguration?: CloudServiceConfiguration

قيمة الخاصية

CloudServiceConfiguration

creationTime

وقت إنشاء التجمع.

creationTime?: Date

قيمة الخاصية

Date

currentDedicatedNodes

عدد عقد الحوسبة المخصصة حاليا في التجمع.

currentDedicatedNodes?: number

قيمة الخاصية

number

currentLowPriorityNodes

عدد عقد الحوسبة ذات الأولوية المنخفضة حاليا في التجمع. يتم تضمين عقد الحوسبة ذات الأولوية المنخفضة التي تم استباقها في هذا العدد.

currentLowPriorityNodes?: number

قيمة الخاصية

number

displayName

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

displayName?: string

قيمة الخاصية

string

enableAutoScale

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

enableAutoScale?: boolean

قيمة الخاصية

boolean

enableInterNodeCommunication

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

enableInterNodeCommunication?: boolean

قيمة الخاصية

boolean

eTag

ETag للتجمع. هذه سلسلة مبهمة. يمكنك استخدامه للكشف عما إذا كان التجمع قد تغير بين الطلبات. على وجه الخصوص، يمكنك تمرير ETag عند تحديث تجمع لتحديد أن التغييرات الخاصة بك يجب أن تصبح سارية المفعول فقط إذا لم يقم أي شخص آخر بتعديل التجمع في هذه الأثناء.

eTag?: string

قيمة الخاصية

string

id

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

id?: string

قيمة الخاصية

string

lastModified

آخر وقت تم تعديله من التجمع. هذه هي المرة الأخيرة التي تتغير فيها بيانات مستوى التجمع، مثل targetDedicatedNodes أو enableAutoscale settings. لا يتم احتساب التغييرات على مستوى العقدة مثل حالة تغيير عقدة الحساب.

lastModified?: Date

قيمة الخاصية

Date

metadata

قائمة أزواج الاسم والقيمة المقترنة بالتجمع كبيانات تعريف.

metadata?: MetadataItem[]

قيمة الخاصية

MetadataItem[]

mountConfiguration

قائمة أنظمة الملفات لتحميلها على كل عقدة في التجمع. يدعم هذا Azure Files وNFS وCSIFS/SMB وBlobfuse.

mountConfiguration?: MountConfiguration[]

قيمة الخاصية

MountConfiguration[]

networkConfiguration

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

networkConfiguration?: NetworkConfiguration

قيمة الخاصية

NetworkConfiguration

resizeErrors

قائمة بالأخطاء التي تمت مواجهتها أثناء إجراء آخر تغيير حجم على التجمع. يتم تعيين هذه الخاصية فقط إذا حدث خطأ واحد أو أكثر أثناء تغيير حجم التجمع الأخير، وعندما يكون Pool allocationState ثابتا فقط.

resizeErrors?: ResizeError[]

قيمة الخاصية

ResizeError[]

resizeTimeout

مهلة تخصيص عقد الحوسبة إلى التجمع. هذه هي المهلة لأحدث عملية تغيير حجم. (يتم احتساب الحجم الأولي عند إنشاء التجمع كتحجيم.) القيمة الافتراضية هي 15 دقيقة.

resizeTimeout?: string

قيمة الخاصية

string

startTask

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

startTask?: StartTask

قيمة الخاصية

StartTask

state

الحالة الحالية للتجمع. تتضمن القيم المحتملة: "نشط" و"حذف"

state?: PoolState

قيمة الخاصية

PoolState

stateTransitionTime

الوقت الذي أدخل فيه التجمع حالته الحالية.

stateTransitionTime?: Date

قيمة الخاصية

Date

stats

إحصائيات الاستخدام واستخدام الموارد طوال مدة بقاء التجمع. يتم ملء هذه الخاصية فقط إذا تم استرداد CloudPool بجملة توسيع بما في ذلك سمة "الإحصائيات"؛ وإلا فهي فارغة. وقد لا تكون الإحصاءات متاحة على الفور. تقوم خدمة Batch بإجراء مجموعة دورية من الإحصائيات. التأخير النموذجي حوالي 30 دقيقة.

stats?: PoolStatistics

قيمة الخاصية

PoolStatistics

targetDedicatedNodes

العدد المطلوب من عقد الحوسبة المخصصة في التجمع.

targetDedicatedNodes?: number

قيمة الخاصية

number

targetLowPriorityNodes

العدد المطلوب من عقد الحوسبة ذات الأولوية المنخفضة في التجمع.

targetLowPriorityNodes?: number

قيمة الخاصية

number

taskSchedulingPolicy

كيفية توزيع المهام عبر عقد الحوسبة في تجمع. إذا لم يتم تحديده، يكون الافتراضي هو spread.

taskSchedulingPolicy?: TaskSchedulingPolicy

قيمة الخاصية

TaskSchedulingPolicy

taskSlotsPerNode

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

taskSlotsPerNode?: number

قيمة الخاصية

number

url

عنوان URL الخاص بالتجمع.

url?: string

قيمة الخاصية

string

userAccounts

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

userAccounts?: UserAccount[]

قيمة الخاصية

UserAccount[]

virtualMachineConfiguration

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

virtualMachineConfiguration?: VirtualMachineConfiguration

قيمة الخاصية

VirtualMachineConfiguration

vmSize

حجم الأجهزة الظاهرية في التجمع. جميع الأجهزة الظاهرية في التجمع بنفس الحجم. للحصول على معلومات حول الأحجام المتوفرة للأجهزة الظاهرية في التجمعات، راجع اختيار حجم الجهاز الظاهري لحساب العقد في تجمع Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

vmSize?: string

قيمة الخاصية

string