CloudPool Sınıf
Azure Batch hizmetinde bir Havuz.
Değişkenler yalnızca sunucu tarafından doldurulur ve istek gönderilirken yoksayılır.
- Devralma
-
CloudPool
Oluşturucu
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)
Parametreler
- id
- str
Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64'ten fazla karakter içeremez. Kimlik büyük/küçük harfe duyarlı değildir ve büyük/küçük harfe duyarlı değildir (başka bir ifadeyle, hesapta yalnızca büyük/küçük harfe göre farklılık gösteren iki kimliğiniz olmayabilir).
- display_name
- str
Görünen adın benzersiz olması gerekmez ve en fazla 1024 uzunluğunda unicode karakter içerebilir.
- url
- str
- e_tag
- str
Bu, opak bir dizedir. Havuzun istekler arasında değişip değişmediğini algılamak için kullanabilirsiniz. Özellikle, bir Havuzu güncelleştirirken ETag'i geçirerek, değişikliklerinizin yalnızca bu sırada Havuzu başka kimsenin değiştirmemiş olması durumunda etkili olacağını belirtebilirsiniz.
- last_modified
- datetime
Bu, targetDedicatedNodes veya enableAutoscale ayarları gibi Havuz düzeyi verilerinin değiştirildiği son durumdur. İşlem Düğümü değiştirme durumu gibi düğüm düzeyindeki değişiklikleri dikkate almaz.
- creation_time
- datetime
- state_transition_time
- datetime
- allocation_state
- str veya AllocationState
Olası değerler şunlardır: 'steady', 'resizing', 'stop'
- allocation_state_transition_time
- datetime
- vm_size
- str
Havuzlardaki sanal makinelerin kullanılabilir boyutları hakkında bilgi için bkz. Azure Batch Havuzundaki İşlem Düğümleri için VM boyutu seçme (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).
- cloud_service_configuration
- CloudServiceConfiguration
Havuz için bulut hizmeti yapılandırması. Bu özellik ve virtualMachineConfiguration birbirini dışlar ve özelliklerden biri belirtilmelidir. Batch Hesabı poolAllocationMode özelliği 'UserSubscription' olarak ayarlanmış şekilde oluşturulduysa bu özellik belirtilemez.
- virtual_machine_configuration
- VirtualMachineConfiguration
Havuz için sanal makine yapılandırması. Bu özellik ve cloudServiceConfiguration birbirini dışlar ve özelliklerden biri belirtilmelidir.
- resize_timeout
- <xref:timedelta>
Bu, en son yeniden boyutlandırma işleminin zaman aşımıdır. (Havuz oluşturulduğunda ilk boyutlandırma yeniden boyutlandırma olarak sayılır.) Varsayılan değer 15 dakikadır.
- resize_errors
- list[ResizeError]
Bu özellik yalnızca son Havuz yeniden boyutlandırması sırasında bir veya daha fazla hata oluştuğunda ve yalnızca Pool allocationState Sabit olduğunda ayarlanır.
- current_low_priority_nodes
- int
Şu anda Havuzda bulunan Spot/Düşük öncelikli İşlem Düğümlerinin sayısı. Bu sayıya önceden eklenen Spot/Düşük öncelikli İşlem Düğümleri dahildir.
- enable_auto_scale
- bool
Havuz boyutunun zaman içinde otomatik olarak ayarlanıp ayarlanmayacağı. False ise en az bir targetDedicatedNodes ve targetLowPriorityNodes belirtilmelidir. True ise autoScaleFormula özelliği gereklidir ve Havuz formüle göre otomatik olarak yeniden boyutlandırılır. Varsayılan değer false'tur.
- auto_scale_formula
- str
Bu özellik yalnızca Havuz otomatik olarak ölçeklendirilirse ayarlanır; örneğin enableAutoScale true olur.
- auto_scale_evaluation_interval
- <xref:timedelta>
Bu özellik yalnızca Havuz otomatik olarak ölçeklendirilirse ayarlanır; örneğin enableAutoScale true olur.
- auto_scale_run
- AutoScaleRun
Otomatik ölçeklendirme formülünün son yürütmesinin sonuçları ve hataları. Bu özellik yalnızca Havuz otomatik olarak ölçeklendirilirse ayarlanır; örneğin enableAutoScale true olur.
- enable_inter_node_communication
- bool
Havuzun İşlem Düğümleri arasında doğrudan iletişime izin verip vermediği. Bu, Havuza atanabilecek İşlem Düğümleri için kısıtlamalar uygular. Bu değerin belirtilmesi, havuza ayrılmasını istediğiniz İşlem Düğümü sayısının olasılığını azaltabilir.
- start_task
- StartTask
Havuza katıldığında her İşlem Düğümünde çalıştırılacak şekilde belirtilen bir Görev.
- certificate_references
- list[CertificateReference]
Windows Düğümleri için Batch hizmeti Sertifikaları belirtilen Sertifika deposuna ve konumuna yükler. Linux İşlem Düğümleri için Sertifikalar Görev çalışma dizini içindeki bir dizinde depolanır ve bu konumu sorgulama görevine AZ_BATCH_CERTIFICATES_DIR bir ortam değişkeni sağlanır. 'remoteUser' görünürlüğüne sahip Sertifikalar için kullanıcının giriş dizininde bir 'certs' dizini oluşturulur (örn. /home/{user-name}/certs) ve Sertifikalar bu dizine yerleştirilir. Uyarı: Bu özellik kullanım dışı bırakıldı ve Şubat 2024'den sonra kaldırılacak. Lütfen bunun yerine Azure KeyVault Uzantısı'nı kullanın.
- application_package_references
- list[ApplicationPackageReference]
Paket başvurularındaki değişiklikler Havuza katılan tüm yeni Düğümleri etkiler, ancak yeniden başlatılana veya yeniden tasarlanana kadar Havuzda bulunan İşlem Düğümlerini etkilemez. Belirli bir Havuzda en fazla 10 Paket başvurusu vardır.
Uygulama lisansları listesi, kullanılabilir Batch hizmeti uygulama lisanslarının bir alt kümesi olmalıdır. Desteklenmeyen bir lisans istenirse Havuz oluşturma başarısız olur.
- task_slots_per_node
- int
Havuzdaki tek bir işlem düğümünde eşzamanlı görevleri çalıştırmak için kullanılabilecek görev yuvalarının sayısı. Varsayılan değer 1’dir. Maksimum değer, havuzun vmSize veya 256 çekirdek sayısının 4 katı kadar küçüktür.
- task_scheduling_policy
- TaskSchedulingPolicy
Görevlerin havuzdaki İşlem Düğümleri arasında nasıl dağıtıldığı. Belirtilmezse varsayılan değer yayılır.
- user_accounts
- list[UserAccount]
- metadata
- list[MetadataItem]
- stats
- PoolStatistics
Havuzun tüm ömrü için kullanım ve kaynak kullanım istatistikleri. Bu özellik yalnızca CloudPool 'stats' özniteliğini içeren bir genişletme yan tümcesi ile alındığında doldurulur; aksi takdirde null olur. İstatistikler hemen kullanılamayabilir. Batch hizmeti, istatistikleri düzenli aralıklarla toplar. Tipik gecikme yaklaşık 30 dakikadır.
- mount_configuration
- list[MountConfiguration]
Bu, Azure Dosyalar, NFS, CIFS/SMB ve Blobfuse'u destekler.
- identity
- BatchPoolIdentity
Yapılandırıldıysa Batch havuzunun kimliği. Batch havuzuyla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtar başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
- target_node_communication_mode
- str veya NodeCommunicationMode
Havuz için istenen düğüm iletişim modu. Atlanırsa varsayılan değer Varsayılan'dır. Olası değerler şunlardır: 'default', 'classic', 'basitleştirilmiş'
Değişkenler
- current_node_communication_mode
- str veya NodeCommunicationMode
Havuz iletişim modunun geçerli durumu. Olası değerler şunlardır: 'default', 'classic', 'basitleştirilmiş'
Yöntemler
as_dict |
json.dump kullanarak JSONify olabilecek bir dikte döndürür. Gelişmiş kullanım isteğe bağlı olarak parametre olarak geri çağırma kullanabilir: Anahtar, Python'da kullanılan öznitelik adıdır. Attr_desc meta verilerin bir diktesidir. Şu anda msrest türüne sahip 'type' ve RestAPI kodlanmış anahtarıyla 'key' içeriyor. Değer, bu nesnedeki geçerli değerdir. Döndürülen dize, anahtarı seri hale getirmek için kullanılır. Dönüş türü bir listeyse, bu hiyerarşik sonuç diktesi olarak kabul edilir. Bu dosyadaki üç örne bakın:
XML serileştirmesini istiyorsanız kwargs is_xml=True değerini geçirebilirsiniz. |
deserialize |
RestAPI söz dizimini kullanarak bir str ayrıştırın ve bir model döndürün. |
enable_additional_properties_sending | |
from_dict |
Verilen anahtar ayıklayıcıyı kullanarak bir dikteyi ayrıştırma bir model döndürür. Varsayılan olarak anahtar ayıklayıcıları (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor ve last_rest_key_case_insensitive_extractor) göz önünde bulundurun |
is_xml_model | |
serialize |
Bu modelden Azure'a gönderilecek JSON'ı döndür. Bu, as_dict(full_restapi_key_transformer, keep_readonly=False) için bir diğer addır. XML serileştirmesini istiyorsanız kwargs is_xml=True değerini geçirebilirsiniz. |
validate |
Bu modeli yinelemeli olarak doğrulayın ve ValidationError listesini döndürür. |
as_dict
json.dump kullanarak JSONify olabilecek bir dikte döndürür.
Gelişmiş kullanım isteğe bağlı olarak parametre olarak geri çağırma kullanabilir:
Anahtar, Python'da kullanılan öznitelik adıdır. Attr_desc meta verilerin bir diktesidir. Şu anda msrest türüne sahip 'type' ve RestAPI kodlanmış anahtarıyla 'key' içeriyor. Değer, bu nesnedeki geçerli değerdir.
Döndürülen dize, anahtarı seri hale getirmek için kullanılır. Dönüş türü bir listeyse, bu hiyerarşik sonuç diktesi olarak kabul edilir.
Bu dosyadaki üç örne bakın:
attribute_transformer
full_restapi_key_transformer
last_restapi_key_transformer
XML serileştirmesini istiyorsanız kwargs is_xml=True değerini geçirebilirsiniz.
as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)
Parametreler
- key_transformer
- <xref:function>
Anahtar transformatör işlevi.
- keep_readonly
Döndürülenler
JSON uyumlu bir nesne dikte
Dönüş türü
deserialize
RestAPI söz dizimini kullanarak bir str ayrıştırın ve bir model döndürün.
deserialize(data, content_type=None)
Parametreler
- content_type
- str
Varsayılan olarak JSON, XML ise application/xml değerini ayarlayın.
Döndürülenler
Bu modelin bir örneği
Özel durumlar
enable_additional_properties_sending
enable_additional_properties_sending()
from_dict
Verilen anahtar ayıklayıcıyı kullanarak bir dikteyi ayrıştırma bir model döndürür.
Varsayılan olarak anahtar ayıklayıcıları (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor ve last_rest_key_case_insensitive_extractor) göz önünde bulundurun
from_dict(data, key_extractors=None, content_type=None)
Parametreler
- content_type
- str
Varsayılan olarak JSON, XML ise application/xml değerini ayarlayın.
- key_extractors
Döndürülenler
Bu modelin bir örneği
Özel durumlar
is_xml_model
is_xml_model()
serialize
Bu modelden Azure'a gönderilecek JSON'ı döndür.
Bu, as_dict(full_restapi_key_transformer, keep_readonly=False) için bir diğer addır.
XML serileştirmesini istiyorsanız kwargs is_xml=True değerini geçirebilirsiniz.
serialize(keep_readonly=False, **kwargs)
Parametreler
- keep_readonly
- bool
Salt okunur öznitelikleri seri hale getirmek istiyorsanız
Döndürülenler
JSON uyumlu bir nesne dikte
Dönüş türü
validate
Bu modeli yinelemeli olarak doğrulayın ve ValidationError listesini döndürür.
validate()
Döndürülenler
Doğrulama hatası listesi
Dönüş türü
Azure SDK for Python
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin