TaskOperations Sınıf

TaskOperations 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.object
TaskOperations

Oluşturucu

TaskOperations(client, config, serializer, deserializer)

Parametreler

client
Gerekli

Hizmet istekleri için istemci.

config
Gerekli

Hizmet istemcisi yapılandırması.

serializer
Gerekli

Nesne modeli seri hale getirici.

deserializer
Gerekli

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 İşe bir Görev ekler.

Görevin tamamlanmasına ek olarak en uzun yaşam süresi 180 gündür. Görev eklendikten sonra 180 gün içinde tamamlanmazsa, Batch hizmeti tarafından sonlandırılır ve o anda olduğu durumda bırakılır.

add_collection

Belirtilen işe bir görev koleksiyonu ekler.

Her görevin benzersiz bir kimliği olması gerektiğini unutmayın. Batch hizmeti, her görevin sonuçlarını bu istekte görevlerin gönderildiği sırayla döndürmeyebilir. Sunucu zaman aşımına uğradıysa veya bağlantı istek sırasında kapatılırsa, istek kısmen veya tamamen işlenmiş ya da hiç işlenmemiş olabilir. Böyle durumlarda, kullanıcı isteği yeniden vermelidir. bir isteği yeniden oluştururken hataları doğru şekilde işlemenin kullanıcıya bağlı olduğunu unutmayın. Örneğin, önceki işlem başarılı olursa yeniden denemenin beklenmedik şekilde ek görevler oluşturmaması için yeniden deneme sırasında aynı görev kimliklerini kullanmanız gerekir. Yanıtta eklenemeyen görevler varsa, istemci isteği yeniden deneyebilir. Yeniden denemede, yalnızca eklenemeyen görevleri yeniden göndermek ve ilk denemede başarıyla eklenen görevleri atlayarak en verimli yöntemdir. Görevin ekten tamamlamaya kadar en uzun ömrü 180 gündür. Bir görev eklendikten sonra 180 gün içinde tamamlanmazsa, Batch hizmeti tarafından sonlandırılır ve o anda hangi durumda olursa olsun bırakılır.

delete

Belirtilen İşten bir Görevi siler.

Bir Görev silindiğinde, çalıştığı İşlem Düğümündeki dizinindeki tüm dosyalar da silinir (saklama süresi ne olursa olsun). Çok örnekli Görevler için Silme Görevi işlemi birincil göreve zaman uyumlu olarak uygulanır; alt görevler ve dosyaları daha sonra arka planda zaman uyumsuz olarak silinir.

get

Belirtilen Görev hakkında bilgi alır.

Çok örnekli Görevler için affinityId, executionInfo ve nodeInfo gibi bilgiler birincil Göreve bakın. Alt görevler hakkında bilgi almak için liste alt görevleri API'sini kullanın.

list

Belirtilen İşle ilişkili tüm Görevleri listeler.

Çok örnekli Görevler için affinityId, executionInfo ve nodeInfo gibi bilgiler birincil Göreve bakın. Alt görevler hakkında bilgi almak için liste alt görevleri API'sini kullanın.

list_subtasks

Belirtilen çok örnekli Görevle ilişkili tüm alt görevleri listeler.

Görev çok örnekli bir Görev değilse, bu boş bir koleksiyon döndürür.

reactivate

Görevi yeniden etkinleştirerek yeniden deneme sayısı tükenmiş olsa bile yeniden çalışmasını sağlar.

Yeniden etkinleştirme, bir Görevi yeniden denenmeye en fazla yeniden deneme sayısı kadar uygun hale getirir. Görevin durumu etkin olarak değiştirilir. Görev artık tamamlanmış durumda olmadığından, yeniden etkinleştirmeden sonra önceki çıkış kodu veya hata bilgileri artık kullanılamaz. Görev her yeniden etkinleştirildiğinde, yeniden deneme sayısı 0'a sıfırlanır. Yeniden etkinleştirme, tamamlanmamış veya daha önce başarıyla tamamlanan Görevler için başarısız olur (0 çıkış koduyla). Buna ek olarak, İş tamamlandıysa (veya sonlandırılıyor veya siliniyorsa) başarısız olur.

terminate

Belirtilen Görevi sonlandırır.

Görev sonlandırıldığında tamamlanmış duruma geçer. Çok örnekli Görevler için, sonlandırma Görevi işlemi birincil göreve zaman uyumlu olarak uygulanır; Alt görevler daha sonra arka planda zaman uyumsuz olarak sonlandırılır.

update

Belirtilen Görevin özelliklerini Güncelleştirmeler.

add

Belirtilen İşe bir Görev ekler.

Görevin tamamlanmasına ek olarak en uzun yaşam süresi 180 gündür. Görev eklendikten sonra 180 gün içinde tamamlanmazsa, Batch hizmeti tarafından sonlandırılır ve o anda olduğu durumda bırakılır.

add(job_id, task, task_add_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

Görevin eklendiği İşin kimliği.

task
TaskAddParameter
Gerekli

Eklenecek Görev.

task_add_options
TaskAddOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

None veya ClientRawResponse if raw=true

Dönüş türü

None,

Özel durumlar

add_collection

Belirtilen işe bir görev koleksiyonu ekler.

Her görevin benzersiz bir kimliği olması gerektiğini unutmayın. Batch hizmeti, her görevin sonuçlarını bu istekte görevlerin gönderildiği sırayla döndürmeyebilir. Sunucu zaman aşımına uğradıysa veya bağlantı istek sırasında kapatılırsa, istek kısmen veya tamamen işlenmiş ya da hiç işlenmemiş olabilir. Böyle durumlarda, kullanıcı isteği yeniden vermelidir. bir isteği yeniden oluştururken hataları doğru şekilde işlemenin kullanıcıya bağlı olduğunu unutmayın. Örneğin, önceki işlem başarılı olursa yeniden denemenin beklenmedik şekilde ek görevler oluşturmaması için yeniden deneme sırasında aynı görev kimliklerini kullanmanız gerekir. Yanıtta eklenemeyen görevler varsa, istemci isteği yeniden deneyebilir. Yeniden denemede, yalnızca eklenemeyen görevleri yeniden göndermek ve ilk denemede başarıyla eklenen görevleri atlayarak en verimli yöntemdir. Görevin ekten tamamlamaya kadar en uzun ömrü 180 gündür. Bir görev eklendikten sonra 180 gün içinde tamamlanmazsa, Batch hizmeti tarafından sonlandırılır ve o anda hangi durumda olursa olsun bırakılır.

add_collection(job_id, value, task_add_collection_options=None, custom_headers=None, raw=False, threads=0, **operation_config)

Parametreler

job_id
str
Gerekli

Görev koleksiyonunun eklendiği işin kimliği.

value
list of TaskAddParameter
Gerekli

Eklenecek görev koleksiyonu. Bu koleksiyonun toplam serileştirilmiş boyutu 4 MB'tan az olmalıdır. 4 MB'tan büyükse (örneğin, her görevin 100'lü kaynak dosyaları veya ortam değişkenleri varsa), istek 'RequestBodyTooLarge' koduyla başarısız olur ve daha az görevle yeniden denenmelidir.

task_add_collection_options
TaskAddCollectionOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

threads
int
varsayılan değer: 0

görevleri eklerken paralel olarak kullanılacak iş parçacığı sayısı. Belirtilirse ve 0'dan büyükse, istekleri göndermek ve bitmesini beklemek için ek iş parçacıkları başlatır. Aksi takdirde add_collection istekleri ana iş parçacığında sıralı olarak gönderir

Döndürülenler

TaskAddCollectionResult veya ClientRawResponse raw=true ise

Dönüş türü

Özel durumlar

azure.batch.custom.CreateTasksErrorException

delete

Belirtilen İşten bir Görevi siler.

Bir Görev silindiğinde, çalıştığı İşlem Düğümündeki dizinindeki tüm dosyalar da silinir (saklama süresi ne olursa olsun). Çok örnekli Görevler için Silme Görevi işlemi birincil göreve zaman uyumlu olarak uygulanır; alt görevler ve dosyaları daha sonra arka planda zaman uyumsuz olarak silinir.

delete(job_id, task_id, task_delete_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

Görevin silineceği İşin kimliği.

task_id
str
Gerekli

Silinecek Görevin Kimliği.

task_delete_options
TaskDeleteOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

None veya ClientRawResponse if raw=true

Dönüş türü

None,

Özel durumlar

get

Belirtilen Görev hakkında bilgi alır.

Çok örnekli Görevler için affinityId, executionInfo ve nodeInfo gibi bilgiler birincil Göreve bakın. Alt görevler hakkında bilgi almak için liste alt görevleri API'sini kullanın.

get(job_id, task_id, task_get_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

Görevi içeren İşin kimliği.

task_id
str
Gerekli

Hakkında bilgi almak için görevin kimliği.

task_get_options
TaskGetOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

CloudTask veya ClientRawResponse if raw=true

Dönüş türü

Özel durumlar

list

Belirtilen İşle ilişkili tüm Görevleri listeler.

Çok örnekli Görevler için affinityId, executionInfo ve nodeInfo gibi bilgiler birincil Göreve bakın. Alt görevler hakkında bilgi almak için liste alt görevleri API'sini kullanın.

list(job_id, task_list_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

İşin Kimliği.

task_list_options
TaskListOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

CloudTask örneği gibi bir yineleyici

Dönüş türü

Özel durumlar

list_subtasks

Belirtilen çok örnekli Görevle ilişkili tüm alt görevleri listeler.

Görev çok örnekli bir Görev değilse, bu boş bir koleksiyon döndürür.

list_subtasks(job_id, task_id, task_list_subtasks_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

İşin Kimliği.

task_id
str
Gerekli

Görevin Kimliği.

task_list_subtasks_options
TaskListSubtasksOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

CloudTaskListSubtasksResult veya ClientRawResponse if raw=true

Dönüş türü

Özel durumlar

reactivate

Görevi yeniden etkinleştirerek yeniden deneme sayısı tükenmiş olsa bile yeniden çalışmasını sağlar.

Yeniden etkinleştirme, bir Görevi yeniden denenmeye en fazla yeniden deneme sayısı kadar uygun hale getirir. Görevin durumu etkin olarak değiştirilir. Görev artık tamamlanmış durumda olmadığından, yeniden etkinleştirmeden sonra önceki çıkış kodu veya hata bilgileri artık kullanılamaz. Görev her yeniden etkinleştirildiğinde, yeniden deneme sayısı 0'a sıfırlanır. Yeniden etkinleştirme, tamamlanmamış veya daha önce başarıyla tamamlanan Görevler için başarısız olur (0 çıkış koduyla). Buna ek olarak, İş tamamlandıysa (veya sonlandırılıyor veya siliniyorsa) başarısız olur.

reactivate(job_id, task_id, task_reactivate_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

Görevi içeren İşin kimliği.

task_id
str
Gerekli

Yeniden etkinleştirilen Görevin Kimliği.

task_reactivate_options
TaskReactivateOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

None veya ClientRawResponse if raw=true

Dönüş türü

None,

Özel durumlar

terminate

Belirtilen Görevi sonlandırır.

Görev sonlandırıldığında tamamlanmış duruma geçer. Çok örnekli Görevler için, sonlandırma Görevi işlemi birincil göreve zaman uyumlu olarak uygulanır; Alt görevler daha sonra arka planda zaman uyumsuz olarak sonlandırılır.

terminate(job_id, task_id, task_terminate_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

Görevi içeren İşin kimliği.

task_id
str
Gerekli

Sonlandıracak görevin kimliği.

task_terminate_options
TaskTerminateOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

None veya ClientRawResponse if raw=true

Dönüş türü

None,

Özel durumlar

update

Belirtilen Görevin özelliklerini Güncelleştirmeler.

update(job_id, task_id, constraints=None, task_update_options=None, custom_headers=None, raw=False, **operation_config)

Parametreler

job_id
str
Gerekli

Görevi içeren İşin kimliği.

task_id
str
Gerekli

Güncelleştirilecek Görevin Kimliği.

constraints
TaskConstraints
varsayılan değer: None

Bu Göreve uygulanan kısıtlamalar. Atlanırsa, Göreve varsayılan kısıtlamalar verilir. Çok örnekli Görevler için bekletme süresini güncelleştirmek yalnızca birincil Görev için geçerlidir, alt görevler için geçerli değildir.

task_update_options
TaskUpdateOptions
varsayılan değer: None

İşlem için ek parametreler

custom_headers
dict
varsayılan değer: None

isteğe eklenecek üst bilgiler

raw
bool
varsayılan değer: False

seri durumdan çıkarılmış yanıtla birlikte doğrudan yanıtı döndürür

operation_config
Gerekli

İşlem yapılandırması geçersiz kılmaları.

Döndürülenler

None veya ClientRawResponse if raw=true

Dönüş türü

None,

Ö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'>