JobSpecification Klasa

Określa szczegóły zadań do utworzenia zgodnie z harmonogramem.

Aby wysyłać na platformę Azure wszystkie wymagane parametry, należy wypełnić wszystkie wymagane parametry.

Dziedziczenie

Model

JobSpecification

Konstruktor

JobSpecification(*, pool_info, priority: int = None, allow_task_preemption: bool = None, max_parallel_tasks: int = -1, display_name: str = None, uses_task_dependencies: bool = None, on_all_tasks_complete=None, on_task_failure=None, network_configuration=None, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, metadata=None, **kwargs)

Parametry

priority

int

Wymagane

Priorytet zadań utworzonych zgodnie z tym harmonogramem. 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. Ten priorytet jest używany jako domyślny dla wszystkich zadań w harmonogramie zadań. Priorytet zadania można zaktualizować po jego utworzeniu przy użyciu interfejsu API zadania aktualizacji.

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 .

display_name

str

Wymagane

Nazwa nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

uses_task_dependencies

bool

Wymagane

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

on_all_tasks_complete

str lub OnAllTasksComplete

Wymagane

Akcja usługi Batch powinna być wykonywana, gdy wszystkie zadania w zadaniu utworzonym w ramach tego harmonogramu są w stanie ukończonym. Należy pamiętać, że jeśli zadanie nie zawiera żadnych zadań, wszystkie zadania są uznawane za ukończone. W związku z tym ta opcja jest najczęściej używana z zadaniem Menedżera zadań; Jeśli chcesz użyć automatycznego kończenia zadań bez Menedżera zadań, najpierw należy ustawić wartość onAllTasksComplete na noaction i zaktualizować właściwości zadania, aby ustawić wartość onAllTasksComplete, aby zakończyć zadanie po zakończeniu dodawania zadań. Wartość domyślna to noaction. Możliwe wartości to: "noAction", "terminateJob"

on_task_failure

str lub OnTaskFailure

Wymagane

Akcja usługi Batch powinna być wykonywana, gdy jakiekolwiek zadanie zakończy się niepowodzeniem w zadaniu utworzonym zgodnie z tym harmonogramem. Zadanie jest uważane za niepowodzenie, jeśli 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.

constraints

JobConstraints

Wymagane

Ograniczenia wykonywania dla zadań utworzonych zgodnie z tym harmonogramem.

job_manager_task

JobManagerTask

Wymagane

Szczegóły zadania menedżera zadań, które mają zostać uruchomione po uruchomieniu zadania zgodnie z tym harmonogramem. Jeśli zadanie nie określi zadania Menedżera zadań, użytkownik musi jawnie dodać zadania do zadania przy użyciu interfejsu API zadań. Jeśli zadanie określi zadanie Menedżera zadań, usługa Batch utworzy zadanie Menedżera zadań po utworzeniu zadania i spróbuje zaplanować zadanie Menedżera zadań przed zaplanowaniem innych zadań w zadaniu.

job_preparation_task

JobPreparationTask

Wymagane

Zadanie przygotowania zadania dla zadań utworzonych zgodnie z tym harmonogramem. Jeśli zadanie ma zadanie przygotowania zadania, usługa Batch uruchomi zadanie przygotowania zadania w węźle przed rozpoczęciem jakichkolwiek zadań tego zadania w tym węźle obliczeniowym.

job_release_task

JobReleaseTask

Wymagane

Zadanie wydania zadania dla zadań utworzonych zgodnie z tym harmonogramem. Głównym celem zadania zwolnienia zadania jest cofnięcie zmian w węzłach wprowadzonych przez zadanie przygotowania zadania. Przykładowe działania obejmują usuwanie plików lokalnych lub zamykanie usług, które zostały uruchomione w ramach przygotowania zadania. Nie można określić zadania wydania zadania bez określania zadania przygotowania zadania dla zadania. Usługa Batch uruchamia zadanie wydania zadania w węzłach obliczeniowych, które uruchamiają zadanie przygotowania 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

Wymagane. Pula, w której usługa Batch uruchamia zadania zadań utworzonych w ramach tego harmonogramu.

metadata

list[MetadataItem]

Wymagane

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

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