PoolOperations Sınıf
PoolOperations işlemleri.
Doğrudan bu sınıfın örneğini oluşturmamalı, ancak sizin için oluşturacak ve öznitelik olarak ekleyecek bir İstemci örneği oluşturmalısınız.
- Devralma
-
builtins.objectPoolOperations
Oluşturucu
PoolOperations(client, config, serializer, deserializer)
Parametreler
- client
Hizmet istekleri için istemci.
- config
Hizmet istemcisi yapılandırması.
- serializer
Nesne modeli seri hale getirici.
- deserializer
Nesne modeli seri durumdan çıkarıcı.
Değişkenler
- api_version
İstek için kullanılacak API sürümü. Sabit değer: "2023-05-01.17.0".
Yöntemler
add |
Belirtilen Hesaba bir Havuz ekler. Havuzları adlandırırken, kullanıcı adları veya gizli proje adları gibi hassas bilgileri eklemekten kaçının. Bu bilgiler, Microsoft Desteği mühendislerin erişebileceği telemetri günlüklerinde görünebilir. |
delete |
Belirtilen Hesaptan bir Havuzu siler. Bir Havuzun silinmesini istediğinizde aşağıdaki eylemler gerçekleşir: Havuz durumu silinecek şekilde ayarlanır; Havuzdaki devam eden yeniden boyutlandırma işlemleri durdurulur; Batch hizmeti Havuzu sıfır İşlem Düğümü olarak yeniden boyutlandırmaya başlar; Mevcut İşlem Düğümlerinde çalışan tüm Görevler sonlandırılır ve yeniden kuyruğrulanır (havuz yeniden boyutlandırma işlemi varsayılan yeniden sıralama seçeneğiyle istenmiş gibi); son olarak, Havuz sistemden kaldırılır. Çalışan Görevler yeniden sorgulandığından, kullanıcı işini farklı bir Havuzu hedeflemek üzere güncelleştirerek bu Görevleri yeniden çalıştırabilir. Görevler daha sonra yeni Havuzda çalıştırılabilir. Yeniden sıralama davranışını geçersiz kılmak istiyorsanız, Havuzu silmeden önce Havuzu sıfır boyuta küçültmek için yeniden boyutlandırma Havuzunu açıkça çağırmanız gerekir. Silme durumundaki bir Havuzda Güncelleştirme, Düzeltme Eki Uygulama veya Silme API'sini çağırırsanız, havuz PoolBeingDeleted hata koduyla 409 HTTP durum koduyla başarısız olur. |
disable_auto_scale |
Havuz için otomatik ölçeklendirmeyi devre dışı bırakır. |
enable_auto_scale |
Havuz için otomatik ölçeklendirmeyi etkinleştirir. Havuz üzerinde yeniden boyutlandırma işlemi devam ederken Havuzda otomatik ölçeklendirmeyi etkinleştiremezsiniz. Havuzun otomatik ölçeklendirmesi şu anda devre dışıysa, isteğin bir parçası olarak geçerli bir otomatik ölçeklendirme formülü belirtmeniz gerekir. Havuzun otomatik ölçeklendirmesi zaten etkinse, yeni bir otomatik ölçeklendirme formülü ve/veya yeni bir değerlendirme aralığı belirtebilirsiniz. Aynı Havuz için bu API'yi 30 saniyede bir birden fazla çağıramazsınız. |
evaluate_auto_scale |
Havuzdaki otomatik ölçeklendirme formülünü değerlendirmenin sonucunu alır. Bu API öncelikli olarak otomatik ölçeklendirme formülünü doğrulamaya yöneliktir. Bunun nedeni, formülü Havuza uygulamadan sonucu döndürmektir. Formülü değerlendirmek için Havuzda otomatik ölçeklendirme etkinleştirilmelidir. |
exists |
Havuzun temel özelliklerini alır. |
get |
Belirtilen Havuz hakkında bilgi alır. |
list |
Belirtilen Hesaptaki tüm Havuzları listeler. |
list_usage_metrics |
Belirtilen Hesap için bireysel zaman aralıklarında Havuz tarafından toplanan kullanım ölçümlerini listeler. PoolId içeren bir $filter yan tümcesi belirtmezseniz yanıt, döndürülen toplama aralıklarının zaman aralığında Hesapta bulunan tüm Havuzları içerir. startTime veya endTime dahil olmak üzere bir $filter yan tümcesi belirtmezseniz, bu filtreler varsayılan olarak şu anda kullanılabilir olan son toplama aralığının başlangıç ve bitiş saatlerine ayarlanmıştır; yani, yalnızca son toplama aralığı döndürülür. |
patch |
Belirtilen Havuzun özelliklerini Güncelleştirmeler. Bu yalnızca istekte belirtilen Havuz özelliklerinin yerini alır. Örneğin, Pool ile ilişkilendirilmiş bir StartTask varsa ve istek bir StartTask öğesi belirtmiyorsa, Pool mevcut StartTask öğesini korur. |
remove_nodes |
Belirtilen Havuzdan İşlem Düğümlerini kaldırır. Bu işlem yalnızca Havuzun ayırma durumu sabit olduğunda çalıştırılabilir. Bu işlem çalıştırıldığında ayırma durumu sabitten yeniden boyutlandırmaya dönüşür. Her istek en fazla 100 düğümü kaldırabilir. |
resize |
Havuza atanan İşlem Düğümlerinin sayısını değiştirir. Havuzu yalnızca ayırma durumu sabit olduğunda yeniden boyutlandırabilirsiniz. Havuz zaten yeniden boyutlandırılıyorsa istek 409 durum koduyla başarısız olur. Havuzu yeniden boyutlandırdığınızda Havuzun ayırma durumu sabitten yeniden boyutlandırmaya dönüşür. Otomatik ölçeklendirme için yapılandırılmış havuzları yeniden boyutlandıramazsınız. Bunu yapmayı denerseniz, Batch hizmeti 409 hatasını döndürür. Havuzu aşağı doğru yeniden boyutlandırırsanız, Batch hizmeti hangi İşlem Düğümlerinin kaldırılacağını seçer. Belirli İşlem Düğümlerini kaldırmak için havuz kaldırma İşlem Düğümleri API'sini kullanın. |
stop_resize |
Havuzda devam eden yeniden boyutlandırma işlemini durdurur. Bu, yeniden boyutlandırma işleminden önce Havuzu önceki durumuna geri yüklemez: yalnızca daha fazla değişiklik yapılmasını durdurur ve Havuz geçerli durumunu korur. Durdurulduktan sonra Havuz, durdurma işlemi tamamlandığında olduğu İşlem Düğümlerinin sayısında kararlı hale gelir. Durdurma işlemi sırasında Havuz ayırma durumu önce durdurulacak, sonra sabit olacak şekilde değişir. Yeniden boyutlandırma işleminin açık bir yeniden boyutlandırma Havuzu isteği olması gerekmez; Bu API, oluşturulduğunda Havuzun ilk boyutlandırmasını durdurmak için de kullanılabilir. |
update_properties |
Belirtilen Havuzun özelliklerini Güncelleştirmeler. Bu, Havuzun tüm güncelleştirilebilir özelliklerinin yerini alır. Örneğin, Havuz ile ilişkilendirilmiş bir StartTask varsa ve StartTask bu istekle belirtilmezse, Batch hizmeti mevcut StartTask'ı kaldırır. |
add
Belirtilen Hesaba bir Havuz ekler.
Havuzları adlandırırken, kullanıcı adları veya gizli proje adları gibi hassas bilgileri eklemekten kaçının. Bu bilgiler, Microsoft Desteği mühendislerin erişebileceği telemetri günlüklerinde görünebilir.
add(pool, pool_add_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
delete
Belirtilen Hesaptan bir Havuzu siler.
Bir Havuzun silinmesini istediğinizde aşağıdaki eylemler gerçekleşir: Havuz durumu silinecek şekilde ayarlanır; Havuzdaki devam eden yeniden boyutlandırma işlemleri durdurulur; Batch hizmeti Havuzu sıfır İşlem Düğümü olarak yeniden boyutlandırmaya başlar; Mevcut İşlem Düğümlerinde çalışan tüm Görevler sonlandırılır ve yeniden kuyruğrulanır (havuz yeniden boyutlandırma işlemi varsayılan yeniden sıralama seçeneğiyle istenmiş gibi); son olarak, Havuz sistemden kaldırılır. Çalışan Görevler yeniden sorgulandığından, kullanıcı işini farklı bir Havuzu hedeflemek üzere güncelleştirerek bu Görevleri yeniden çalıştırabilir. Görevler daha sonra yeni Havuzda çalıştırılabilir. Yeniden sıralama davranışını geçersiz kılmak istiyorsanız, Havuzu silmeden önce Havuzu sıfır boyuta küçültmek için yeniden boyutlandırma Havuzunu açıkça çağırmanız gerekir. Silme durumundaki bir Havuzda Güncelleştirme, Düzeltme Eki Uygulama veya Silme API'sini çağırırsanız, havuz PoolBeingDeleted hata koduyla 409 HTTP durum koduyla başarısız olur.
delete(pool_id, pool_delete_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
disable_auto_scale
Havuz için otomatik ölçeklendirmeyi devre dışı bırakır.
disable_auto_scale(pool_id, pool_disable_auto_scale_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- pool_disable_auto_scale_options
- PoolDisableAutoScaleOptions
İşlem için ek parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
enable_auto_scale
Havuz için otomatik ölçeklendirmeyi etkinleştirir.
Havuz üzerinde yeniden boyutlandırma işlemi devam ederken Havuzda otomatik ölçeklendirmeyi etkinleştiremezsiniz. Havuzun otomatik ölçeklendirmesi şu anda devre dışıysa, isteğin bir parçası olarak geçerli bir otomatik ölçeklendirme formülü belirtmeniz gerekir. Havuzun otomatik ölçeklendirmesi zaten etkinse, yeni bir otomatik ölçeklendirme formülü ve/veya yeni bir değerlendirme aralığı belirtebilirsiniz. Aynı Havuz için bu API'yi 30 saniyede bir birden fazla çağıramazsınız.
enable_auto_scale(pool_id, auto_scale_formula=None, auto_scale_evaluation_interval=None, pool_enable_auto_scale_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- auto_scale_formula
- str
Formül Havuza uygulanmadan önce 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/en-us/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 isteği geçersiz özellik değeri hatasıyla reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400'dür (Hatalı İstek). Yeni bir aralık belirtirseniz, mevcut otomatik ölçeklendirme değerlendirme zamanlaması durdurulur ve yeni bir otomatik ölçeklendirme değerlendirme zamanlaması başlatılır ve başlangıç saati bu isteğin verildiği zamandır.
- pool_enable_auto_scale_options
- PoolEnableAutoScaleOptions
İşlem için ek parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
evaluate_auto_scale
Havuzdaki otomatik ölçeklendirme formülünü değerlendirmenin sonucunu alır.
Bu API öncelikli olarak otomatik ölçeklendirme formülünü doğrulamaya yöneliktir. Bunun nedeni, formülü Havuza uygulamadan sonucu döndürmektir. Formülü değerlendirmek için Havuzda otomatik ölçeklendirme etkinleştirilmelidir.
evaluate_auto_scale(pool_id, auto_scale_formula, pool_evaluate_auto_scale_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- auto_scale_formula
- str
Formül doğrulanır ve sonuçları hesaplanır, ancak Havuza uygulanmaz. Formülü Havuza uygulamak için 'Havuzda otomatik ölçeklendirmeyi etkinleştir'. 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/en-us/documentation/articles/batch-automatic-scaling).
- pool_evaluate_auto_scale_options
- PoolEvaluateAutoScaleOptions
İşlem için ek parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
Raw=true ise AutoScaleRun veya ClientRawResponse
Dönüş türü
Özel durumlar
exists
Havuzun temel özelliklerini alır.
exists(pool_id, pool_exists_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
bool veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
get
Belirtilen Havuz hakkında bilgi alır.
get(pool_id, pool_get_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
CloudPool veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
list
Belirtilen Hesaptaki tüm Havuzları listeler.
list(pool_list_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
CloudPool örneği gibi bir yineleyici
Dönüş türü
Özel durumlar
list_usage_metrics
Belirtilen Hesap için bireysel zaman aralıklarında Havuz tarafından toplanan kullanım ölçümlerini listeler.
PoolId içeren bir $filter yan tümcesi belirtmezseniz yanıt, döndürülen toplama aralıklarının zaman aralığında Hesapta bulunan tüm Havuzları içerir. startTime veya endTime dahil olmak üzere bir $filter yan tümcesi belirtmezseniz, bu filtreler varsayılan olarak şu anda kullanılabilir olan son toplama aralığının başlangıç ve bitiş saatlerine ayarlanmıştır; yani, yalnızca son toplama aralığı döndürülür.
list_usage_metrics(pool_list_usage_metrics_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- pool_list_usage_metrics_options
- PoolListUsageMetricsOptions
İşlem için ek parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
PoolUsageMetrics örneği gibi bir yineleyici
Dönüş türü
Özel durumlar
patch
Belirtilen Havuzun özelliklerini Güncelleştirmeler.
Bu yalnızca istekte belirtilen Havuz özelliklerinin yerini alır. Örneğin, Pool ile ilişkilendirilmiş bir StartTask varsa ve istek bir StartTask öğesi belirtmiyorsa, Pool mevcut StartTask öğesini korur.
patch(pool_id, pool_patch_parameter, pool_patch_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
remove_nodes
Belirtilen Havuzdan İşlem Düğümlerini kaldırır.
Bu işlem yalnızca Havuzun ayırma durumu sabit olduğunda çalıştırılabilir. Bu işlem çalıştırıldığında ayırma durumu sabitten yeniden boyutlandırmaya dönüşür. Her istek en fazla 100 düğümü kaldırabilir.
remove_nodes(pool_id, node_remove_parameter, pool_remove_nodes_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
resize
Havuza atanan İşlem Düğümlerinin sayısını değiştirir.
Havuzu yalnızca ayırma durumu sabit olduğunda yeniden boyutlandırabilirsiniz. Havuz zaten yeniden boyutlandırılıyorsa istek 409 durum koduyla başarısız olur. Havuzu yeniden boyutlandırdığınızda Havuzun ayırma durumu sabitten yeniden boyutlandırmaya dönüşür. Otomatik ölçeklendirme için yapılandırılmış havuzları yeniden boyutlandıramazsınız. Bunu yapmayı denerseniz, Batch hizmeti 409 hatasını döndürür. Havuzu aşağı doğru yeniden boyutlandırırsanız, Batch hizmeti hangi İşlem Düğümlerinin kaldırılacağını seçer. Belirli İşlem Düğümlerini kaldırmak için havuz kaldırma İşlem Düğümleri API'sini kullanın.
resize(pool_id, pool_resize_parameter, pool_resize_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
stop_resize
Havuzda devam eden yeniden boyutlandırma işlemini durdurur.
Bu, yeniden boyutlandırma işleminden önce Havuzu önceki durumuna geri yüklemez: yalnızca daha fazla değişiklik yapılmasını durdurur ve Havuz geçerli durumunu korur. Durdurulduktan sonra Havuz, durdurma işlemi tamamlandığında olduğu İşlem Düğümlerinin sayısında kararlı hale gelir. Durdurma işlemi sırasında Havuz ayırma durumu önce durdurulacak, sonra sabit olacak şekilde değişir. Yeniden boyutlandırma işleminin açık bir yeniden boyutlandırma Havuzu isteği olması gerekmez; Bu API, oluşturulduğunda Havuzun ilk boyutlandırmasını durdurmak için de kullanılabilir.
stop_resize(pool_id, pool_stop_resize_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
update_properties
Belirtilen Havuzun özelliklerini Güncelleştirmeler.
Bu, Havuzun tüm güncelleştirilebilir özelliklerinin yerini alır. Örneğin, Havuz ile ilişkilendirilmiş bir StartTask varsa ve StartTask bu istekle belirtilmezse, Batch hizmeti mevcut StartTask'ı kaldırır.
update_properties(pool_id, pool_update_properties_parameter, pool_update_properties_options=None, custom_headers=None, raw=False, **operation_config)
Parametreler
- pool_update_properties_options
- PoolUpdatePropertiesOptions
İşlem için ek parametreler
- operation_config
İşlem yapılandırması geçersiz kılmaları.
Döndürülenler
None veya ClientRawResponse if raw=true
Dönüş türü
Özel durumlar
Öznitelikler
models
models = <module 'azure.batch.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\batch\\models\\__init__.py'>
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