PoolAddParameter Sınıf
Eklenecek Azure Batch hizmetinde bir Havuz.
Azure'a göndermek için tüm gerekli parametrelerin doldurulması gerekir.
- Devralma
-
PoolAddParameter
Oluşturucu
PoolAddParameter(*, id: str, vm_size: str, display_name: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=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, 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, mount_configuration=None, target_node_communication_mode=None, **kwargs)
Parametreler
- id
- str
Gereklidir. Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64 karakterden fazlasını içeremez. Kimlik büyük/küçük harfe duyarlı 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 Havuz Kimliğiniz olmayabilir).
- display_name
- str
Görünen adın benzersiz olması gerekmez ve en fazla 1024 uzunluğunda unicode karakter içerebilir.
- vm_size
- str
Gereklidir. Cloud Services Havuzları (cloudServiceConfiguration ile oluşturulan havuzlar) için kullanılabilir sanal makine boyutları hakkında bilgi için bkz. Cloud Services boyutları (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch, ExtraSmall, A1V2 ve A2V2 dışında tüm Cloud Services VM boyutlarını destekler. Sanal Makineler Marketi'nden (virtualMachineConfiguration ile oluşturulan havuzlar) Görüntü Kullanan Havuzlar için kullanılabilir VM boyutları hakkında bilgi için bkz. Sanal Makineler Için Boyutlar (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) veya Sanal Makineler Boyutları (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch, STANDARD_A0 ve premium depolama alanı (STANDARD_GS, STANDARD_DS ve STANDARD_DSV2 serisi) olanlar dışında tüm Azure VM boyutlarını destekler.
- 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 zaman aşımı yalnızca el ile ölçeklendirme için geçerlidir; enableAutoScale true olarak ayarlandığında hiçbir etkisi olmaz. Varsayılan değer 15 dakikadır. En düşük değer 5 dakikadır. 5 dakikadan kısa bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).
- target_dedicated_nodes
- int
Havuzdaki ayrılmış İşlem Düğümlerinin istenen sayısı. enableAutoScale true olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale false olarak ayarlanırsa targetDedicatedNodes, targetLowPriorityNodes veya her ikisini de ayarlamanız gerekir.
- target_low_priority_nodes
- int
Havuzdaki spot/düşük öncelikli işlem düğümlerinin istenen sayısı. enableAutoScale true olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale false olarak ayarlanırsa targetDedicatedNodes, targetLowPriorityNodes veya her ikisini de ayarlamanız gerekir.
- enable_auto_scale
- bool
Havuz boyutunun zaman içinde otomatik olarak ayarlanıp ayarlanmayacağı. False ise, targetDedicatedNodes ve targetLowPriorityNodes'lardan en az biri 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
enableAutoScale false olarak ayarlandıysa bu özellik belirtilmemelidir. enableAutoScale true olarak ayarlandıysa gereklidir. Havuz oluşturulmadan önce formül geçerliliği denetlendi. Formül geçerli değilse Batch hizmeti ayrıntılı hata bilgileriyle isteği reddeder. Bu formülü belirtme hakkında daha fazla bilgi için bkz. 'Azure Batch Havuzunda İşlem Düğümlerini otomatik olarak ölçeklendirme' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
- auto_scale_evaluation_interval
- <xref:timedelta>
Varsayılan değer 15 dakikadır. En düşük ve en yüksek değer sırasıyla 5 dakika ve 168 saattir. 5 dakikadan kısa veya 168 saatten büyük bir değer belirtirseniz, Batch hizmeti bir hata döndürür; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek).
- enable_inter_node_communication
- bool
Havuzun İşlem Düğümleri arasında doğrudan iletişime izin verip vermediği. Düğümler arası iletişimin etkinleştirilmesi, Havuzun İşlem Düğümlerindeki dağıtım kısıtlamaları nedeniyle Havuzun en büyük boyutunu sınırlar. Bu durum Havuzun istenen boyuta ulaşmamasıyla sonuçlanabilir. Varsayılan değer false'tur.
- start_task
- StartTask
Havuza katıldığında her İşlem Düğümünde çalıştırılacak şekilde belirtilen bir Görev. Görev, İşlem Düğümü Havuza eklendiğinde veya İşlem Düğümü yeniden başlatıldığında çalışır.
- 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 sorgulamak üzere Göreve bir ortam değişkeni AZ_BATCH_CERTIFICATES_DIR sağlanır. 'remoteUser' görünürlüğüne sahip sertifikalar için, kullanıcının giriş dizininde bir 'certs' dizini oluşturulur (ör. /home/{user-name}/certs) ve Sertifikalar bu dizine yerleştirilir. Uyarı: Bu özellik kullanım dışıdır ve Şubat 2024'den sonra kaldırılacaktır. Lütfen bunun yerine Azure KeyVault Uzantısını kullanın.
- application_package_references
- list[ApplicationPackageReference]
Havuz oluştururken paketin uygulama kimliği tam olmalıdır (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). 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 yuvası 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]
Batch hizmeti meta veriler için herhangi bir anlam atamaz; yalnızca kullanıcı kodunun kullanımına yöneliktir.
- mount_configuration
- list[MountConfiguration]
Azure dosya paylaşımı, NFS, CIFS veya Blobfuse tabanlı dosya sistemini kullanarak depolamayı bağlayın.
- 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ş'
Yöntemler
as_dict |
json.dump kullanarak JSONify olabilecek bir dikte döndürebilirsiniz. Gelişmiş kullanım isteğe bağlı olarak parametre olarak bir geri çağırma kullanabilir: Anahtar, Python'da kullanılan öznitelik adıdır. Attr_desc, meta verilerin bir diktesidir. Şu anda msrest türüyle 'type' ve RestAPI kodlanmış anahtarıyla 'key' içerir. 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ştirme istiyorsanız, kwargs is_xml=True 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 kodunu döndür. Bu, as_dict(full_restapi_key_transformer, keep_readonly=False) için bir diğer addır. XML serileştirme istiyorsanız, kwargs is_xml=True 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ürebilirsiniz.
Gelişmiş kullanım isteğe bağlı olarak parametre olarak bir geri çağırma kullanabilir:
Anahtar, Python'da kullanılan öznitelik adıdır. Attr_desc, meta verilerin bir diktesidir. Şu anda msrest türüyle 'type' ve RestAPI kodlanmış anahtarıyla 'key' içerir. 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ştirme istiyorsanız, kwargs is_xml=True 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 dikte nesnesi
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
JSON varsayılan olarak, 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
JSON varsayılan olarak, 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 kodunu döndür.
Bu, as_dict(full_restapi_key_transformer, keep_readonly=False) için bir diğer addır.
XML serileştirme istiyorsanız, kwargs is_xml=True 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 dikte nesnesi
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