CloudPool الفصل

تجمع في خدمة Azure Batch.

يتم ملء المتغيرات بواسطة الخادم فقط، وسيتم تجاهلها عند إرسال طلب.

توريث

Model

CloudPool

الدالمنشئ

CloudPool(*, id: str = None, display_name: str = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, allocation_state=None, allocation_state_transition_time=None, vm_size: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, resize_errors=None, current_dedicated_nodes: int = None, current_low_priority_nodes: int = None, target_dedicated_nodes: int = None, target_low_priority_nodes: int = None, enable_auto_scale: bool = None, auto_scale_formula: str = None, auto_scale_evaluation_interval=None, auto_scale_run=None, enable_inter_node_communication: bool = None, network_configuration=None, start_task=None, certificate_references=None, application_package_references=None, application_licenses=None, task_slots_per_node: int = None, task_scheduling_policy=None, user_accounts=None, metadata=None, stats=None, mount_configuration=None, identity=None, target_node_communication_mode=None, **kwargs)

المعلمات

id

str

مطلوب

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

display_name

str

مطلوب

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

url

str

مطلوب

e_tag

str

مطلوب

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

last_modified

datetime

مطلوب

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

creation_time

datetime

مطلوب

state

str أو PoolState

مطلوب

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

state_transition_time

datetime

مطلوب

allocation_state

str أو AllocationState

مطلوب

تتضمن القيم المحتملة: "ثابت" و"تغيير الحجم" و"إيقاف"

allocation_state_transition_time

datetime

مطلوب

vm_size

str

مطلوب

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

cloud_service_configuration

CloudServiceConfiguration

مطلوب

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

virtual_machine_configuration

VirtualMachineConfiguration

مطلوب

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

resize_timeout

<xref:timedelta>

مطلوب

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

resize_errors

list[ResizeError]

مطلوب

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

current_dedicated_nodes

int

مطلوب

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

current_low_priority_nodes

int

مطلوب

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

target_dedicated_nodes

int

مطلوب

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

target_low_priority_nodes

int

مطلوب

العدد المطلوب من Spot/Low-priority Compute Nodes في التجمع.

enable_auto_scale

bool

مطلوب

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

auto_scale_formula

str

مطلوب

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

auto_scale_evaluation_interval

<xref:timedelta>

مطلوب

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

auto_scale_run

AutoScaleRun

مطلوب

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

enable_inter_node_communication

bool

مطلوب

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

network_configuration

NetworkConfiguration

مطلوب

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

start_task

StartTask

مطلوب

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

certificate_references

list[CertificateReference]

مطلوب

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

application_package_references

list[ApplicationPackageReference]

مطلوب

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

application_licenses

list[str]

مطلوب

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

task_slots_per_node

int

مطلوب

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

task_scheduling_policy

TaskSchedulingPolicy

مطلوب

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

user_accounts

list[UserAccount]

مطلوب

metadata

list[MetadataItem]

مطلوب

stats

PoolStatistics

مطلوب

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

mount_configuration

list[MountConfiguration]

مطلوب

يدعم هذا Azure Files وNFS وCIFS/SMB وBlobfuse.

identity

BatchPoolIdentity

مطلوب

هوية تجمع الدفعات، إذا تم تكوينها. قائمة هويات المستخدم المقترنة بتجمع الدفعات. ستكون المراجع الرئيسية لقاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

target_node_communication_mode

str أو NodeCommunicationMode

مطلوب

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

المتغيرات

current_node_communication_mode

str أو NodeCommunicationMode

الحالة الحالية لوضع اتصال التجمع. تتضمن القيم المحتملة: "افتراضي" و"كلاسيكي" و"مبسط"

الأساليب

as_dict	إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump. قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا: المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو إملاء لبيانات التعريف. يحتوي حاليا على "type" بنوع msrest و"key" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن. سيتم استخدام السلسلة التي تم إرجاعها لتسلسل المفتاح. إذا كان نوع الإرجاع عبارة عن قائمة، يعتبر ذلك إملاءا للنتيجة الهرمية. راجع الأمثلة الثلاثة في هذا الملف: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
deserialize	تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.
enable_additional_properties_sending
from_dict	تحليل إملاء باستخدام مستخرج مفتاح معين يرجع نموذجا. بشكل افتراضي، ضع في اعتبارك مستخرجات المفاتيح (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج. هذا اسم مستعار as_dict (full_restapi_key_transformer، keep_readonly=خطأ). إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.
validate	تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

as_dict

إرجاع إملاء يمكن أن يكون JSONify باستخدام json.dump.

قد يستخدم الاستخدام المتقدم رد اتصال كمعلمة اختياريا:

المفتاح هو اسم السمة المستخدم في Python. Attr_desc هو إملاء لبيانات التعريف. يحتوي حاليا على "type" بنوع msrest و"key" مع المفتاح المشفرة RestAPI. القيمة هي القيمة الحالية في هذا الكائن.

سيتم استخدام السلسلة التي تم إرجاعها لتسلسل المفتاح. إذا كان نوع الإرجاع عبارة عن قائمة، يعتبر ذلك إملاءا للنتيجة الهرمية.

راجع الأمثلة الثلاثة في هذا الملف:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

المعلمات

key_transformer

<xref:function>

دالة محول مفاتيح.

keep_readonly

القيمة الافتراضية: True

المرتجعات

كائن متوافق مع JSON لل dict

نوع الإرجاع

dict

deserialize

تحليل سلسلة باستخدام بناء جملة RestAPI وإرجاع نموذج.

deserialize(data, content_type=None)

المعلمات

data

str

مطلوب

سلسلة باستخدام بنية RestAPI. JSON بشكل افتراضي.

content_type

str

القيمة الافتراضية: None

JSON بشكل افتراضي، قم بتعيين application/xml إذا كان XML.

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

تحليل إملاء باستخدام مستخرج مفتاح معين يرجع نموذجا.

بشكل افتراضي، ضع في اعتبارك مستخرجات المفاتيح (rest_key_case_insensitive_extractor attribute_key_case_insensitive_extractor last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

المعلمات

data

dict

مطلوب

إملاء باستخدام بنية RestAPI

content_type

str

القيمة الافتراضية: None

JSON بشكل افتراضي، قم بتعيين application/xml إذا كان XML.

key_extractors

القيمة الافتراضية: None

المرتجعات

مثيل لهذا النموذج

استثناءات

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

إرجاع JSON الذي سيتم إرساله إلى azure من هذا النموذج.

هذا اسم مستعار as_dict (full_restapi_key_transformer، keep_readonly=خطأ).

إذا كنت تريد تسلسل XML، يمكنك تمرير kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

المعلمات

keep_readonly

bool

القيمة الافتراضية: False

إذا كنت تريد إجراء تسلسل للسمات للقراءة فقط

المرتجعات

كائن متوافق مع JSON لل dict

نوع الإرجاع

dict

validate

تحقق من صحة هذا النموذج بشكل متكرر وأعد قائمة ValidationError.

validate()

المرتجعات

قائمة بخطأ التحقق من الصحة

نوع الإرجاع

list