CloudJob Klasa

Zadanie Azure Batch.

Dziedziczenie

Model

CloudJob

Konstruktor

CloudJob(*, id: str = None, display_name: str = None, uses_task_dependencies: bool = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, previous_state=None, previous_state_transition_time=None, priority: int = None, allow_task_preemption: bool = None, max_parallel_tasks: int = -1, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, pool_info=None, on_all_tasks_complete=None, on_task_failure=None, network_configuration=None, metadata=None, execution_info=None, stats=None, **kwargs)

Parametry

id

str

Wymagane

Identyfikator jest zachowywany wielkości liter i niewrażliwy na wielkość liter (oznacza to, że nie masz dwóch identyfikatorów w ramach konta, które różnią się tylko wielkością liter).

display_name

str

Wymagane

uses_task_dependencies

bool

Wymagane

Czy zadania w zadaniu mogą definiować zależności od siebie. Wartością domyślną jest false.

url

str

Wymagane

e_tag

str

Wymagane

Jest to nieprzezroczystych ciągów. Można go użyć do wykrywania, czy zadanie zostało zmienione między żądaniami. W szczególności można przekazać element ETag podczas aktualizowania zadania w celu określenia, że zmiany powinny obowiązywać tylko wtedy, gdy nikt inny nie zmodyfikował zadania w międzyczasie.

last_modified

datetime

Wymagane

Jest to ostatni raz, w którym dane poziomu zadania, takie jak stan zadania lub priorytet, uległy zmianie. Nie uwzględnia zmian na poziomie zadania, takich jak dodawanie nowych zadań lub zadań zmieniających stan.

creation_time

datetime

Wymagane

state

str lub JobState

Wymagane

Bieżący stan zadania. Możliwe wartości obejmują: "aktywne", "wyłączanie", "wyłączone", "włączanie", "kończenie", "ukończone", "usuwanie"

state_transition_time

datetime

Wymagane

previous_state

str lub JobState

Wymagane

Poprzedni stan zadania. Ta właściwość nie jest ustawiona, jeśli zadanie ma początkowy stan Aktywny. Możliwe wartości obejmują: "aktywne", "wyłączanie", "wyłączone", "włączanie", "kończenie", "ukończone", "usuwanie"

previous_state_transition_time

datetime

Wymagane

Ta właściwość nie jest ustawiona, jeśli zadanie ma początkowy stan Aktywny.

priority

int

Wymagane

Priorytet zadania. Wartości priorytetu mogą wahać się od -1000 do 1000, a wartość -1000 jest najniższym priorytetem i 1000 jest najwyższym priorytetem. Wartość domyślna to 0.

allow_task_preemption

bool

Wymagane

Czy zadania w tym zadaniu mogą być wywłaszczone przez inne zadania o wysokim priorytcie. Jeśli wartość ma wartość True, inne zadania o wysokim priorytetu przesłane do systemu będą miały pierwszeństwo i będą mogły ponownie kolejkować zadania z tego zadania. Po utworzeniu zadania można zaktualizować element allowTaskPreemption zadania przy użyciu interfejsu API zadania aktualizacji.

max_parallel_tasks

int

Wymagane

Maksymalna liczba zadań, które można wykonać równolegle dla zadania. Wartość parametru maxParallelTasks musi być -1 lub większa niż 0, jeśli zostanie określona. Jeśli nie zostanie określona, wartość domyślna to -1, co oznacza, że nie ma limitu liczby zadań, które można uruchamiać jednocześnie. Po utworzeniu zadania można zaktualizować element maxParallelTasks zadania przy użyciu interfejsu API zadania aktualizacji. Wartość domyślna: -1 .

constraints

JobConstraints

Wymagane

Ograniczenia wykonywania zadania.

job_manager_task

JobManagerTask

Wymagane

Szczegóły zadania menedżera zadań do uruchomienia po uruchomieniu zadania.

job_preparation_task

JobPreparationTask

Wymagane

Zadanie przygotowania zadania. Zadanie przygotowania zadania to specjalne zadanie uruchamiane w każdym węźle obliczeniowym przed innym zadaniem zadania.

job_release_task

JobReleaseTask

Wymagane

Zadanie wydania zadania. Zadanie wydania zadania to specjalne zadanie uruchamiane na końcu zadania na każdym węźle obliczeniowym, które uruchamia inne zadanie zadania zadania.

common_environment_settings

list[EnvironmentSetting]

Wymagane

Poszczególne zadania mogą zastąpić ustawienie środowiska określone tutaj, określając tę samą nazwę ustawienia o innej wartości.

pool_info

PoolInformation

Wymagane

Ustawienia puli skojarzone z zadaniem.

on_all_tasks_complete

str lub OnAllTasksComplete

Wymagane

Akcja, jaką usługa Batch powinna wykonać, gdy wszystkie zadania w zadaniu są w stanie ukończonym. Wartość domyślna to noaction. Możliwe wartości to: "noAction", "terminateJob"

on_task_failure

str lub OnTaskFailure

Wymagane

Akcja, jaką usługa Batch powinna wykonać, gdy jakiekolwiek zadanie w zadaniu zakończy się niepowodzeniem. Zadanie jest uważane za nie powiodło się, jeśli wystąpił błądInfo. BłądInfo jest ustawiany, jeśli zadanie kończy się kodem zakończenia niezerowym po wyczerpaniu liczby ponownych prób lub jeśli wystąpił błąd podczas uruchamiania zadania, na przykład z powodu błędu pobierania pliku zasobu. Wartość domyślna to noaction. Możliwe wartości to: "noAction", "performExitOptionsJobAction"

network_configuration

JobNetworkConfiguration

Wymagane

Konfiguracja sieci zadania.

metadata

list[MetadataItem]

Wymagane

Usługa Batch nie przypisuje żadnego znaczenia do metadanych; służy wyłącznie do używania kodu użytkownika.

execution_info

JobExecutionInformation

Wymagane

Informacje o wykonaniu zadania.

stats

JobStatistics

Wymagane

Statystyki użycia zasobów dla całego okresu istnienia zadania. Ta właściwość jest wypełniana tylko wtedy, gdy obiekt CloudJob został pobrany z klauzulą rozwijania, w tym atrybutem "stats"; w przeciwnym razie ma wartość null. Statystyki mogą nie być natychmiast dostępne. Usługa Batch wykonuje okresowe zestawienie statystyk. Typowe opóźnienie wynosi około 30 minut.

Metody

as_dict	Zwróć dykt, który może być JSONify przy użyciu pliku json.dump. Użycie zaawansowane może opcjonalnie używać wywołania zwrotnego jako parametru: Klucz to nazwa atrybutu używana w języku Python. Attr_desc to dykt metadanych. Obecnie zawiera ciąg "type" z typem msrest i kluczem zakodowanym w interfejsie RESTAPI. Wartość jest bieżącą wartością w tym obiekcie. Zwrócony ciąg będzie używany do serializacji klucza. Jeśli zwracany typ jest listą, jest to uważane za hierarchiczne dykt wyniku. Zobacz trzy przykłady w tym pliku: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.
deserialize	Analizowanie ciągu przy użyciu składni restAPI i zwracanie modelu.
enable_additional_properties_sending
from_dict	Przeanalizuj dykt przy użyciu danego wyodrębniającego klucz zwraca model. Domyślnie należy wziąć pod uwagę wyodrębniacze kluczy (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor i last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	Zwróć kod JSON, który zostanie wysłany na platformę Azure z tego modelu. Jest to alias as_dict(full_restapi_key_transformer, keep_readonly=False). Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.
validate	Zweryfikuj ten model cyklicznie i zwróć listę wartości ValidationError.

as_dict

Zwróć dykt, który może być JSONify przy użyciu pliku json.dump.

Użycie zaawansowane może opcjonalnie używać wywołania zwrotnego jako parametru:

Klucz to nazwa atrybutu używana w języku Python. Attr_desc to dykt metadanych. Obecnie zawiera ciąg "type" z typem msrest i kluczem zakodowanym w interfejsie RESTAPI. Wartość jest bieżącą wartością w tym obiekcie.

Zwrócony ciąg będzie używany do serializacji klucza. Jeśli zwracany typ jest listą, jest to uważane za hierarchiczne dykt wyniku.

Zobacz trzy przykłady w tym pliku:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.

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

Parametry

key_transformer

<xref:function>

Funkcja przekształcania klucza.

keep_readonly

wartość domyślna: True

Zwraca

Obiekt zgodny z JSON w formacie JSON

Typ zwracany

dict

deserialize

Analizowanie ciągu przy użyciu składni restAPI i zwracanie modelu.

deserialize(data, content_type=None)

Parametry

data

str

Wymagane

Str używający struktury RestAPI. Domyślnie kod JSON.

content_type

str

wartość domyślna: None

Domyślnie w formacie JSON ustaw wartość application/xml, jeśli plik XML.

Zwraca

Wystąpienie tego modelu

Wyjątki

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Przeanalizuj dykt przy użyciu danego wyodrębniającego klucz zwraca model.

Domyślnie należy wziąć pod uwagę wyodrębniacze kluczy (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor i last_rest_key_case_insensitive_extractor)

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

Parametry

data

dict

Wymagane

Dykt używający struktury RESTAPI

content_type

str

wartość domyślna: None

Domyślnie w formacie JSON ustaw wartość application/xml, jeśli plik XML.

key_extractors

wartość domyślna: None

Zwraca

Wystąpienie tego modelu

Wyjątki

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Zwróć kod JSON, który zostanie wysłany na platformę Azure z tego modelu.

Jest to alias as_dict(full_restapi_key_transformer, keep_readonly=False).

Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parametry

keep_readonly

bool

wartość domyślna: False

Jeśli chcesz serializować atrybuty readonly

Zwraca

Obiekt zgodny z JSON w formacie JSON

Typ zwracany

dict

validate

Zweryfikuj ten model cyklicznie i zwróć listę wartości ValidationError.

validate()

Zwraca

Lista błędów weryfikacji

Typ zwracany

list