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
-
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
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
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
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
Nazwa nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.
- uses_task_dependencies
- bool
Czy zadania w zadaniu mogą definiować zależności od siebie. Wartością domyślną jest false.
- on_all_tasks_complete
- str lub OnAllTasksComplete
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
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"
- constraints
- JobConstraints
Ograniczenia wykonywania dla zadań utworzonych zgodnie z tym harmonogramem.
- job_manager_task
- JobManagerTask
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
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
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]
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. Pula, w której usługa Batch uruchamia zadania zadań utworzonych w ramach tego harmonogramu.
- metadata
- list[MetadataItem]
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:
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
Zwraca
Obiekt zgodny z JSON w formacie JSON
Typ zwracany
deserialize
Analizowanie ciągu przy użyciu składni restAPI i zwracanie modelu.
deserialize(data, content_type=None)Parametry
- content_type
- str
Domyślnie w formacie JSON ustaw wartość application/xml, jeśli plik XML.
Zwraca
Wystąpienie tego modelu
Wyjątki
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
- content_type
- str
Domyślnie w formacie JSON ustaw wartość application/xml, jeśli plik XML.
- key_extractors
Zwraca
Wystąpienie tego modelu
Wyjątki
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
Zwraca
Obiekt zgodny z JSON w formacie JSON
Typ zwracany
validate
Zweryfikuj ten model cyklicznie i zwróć listę wartości ValidationError.
validate()Zwraca
Lista błędów weryfikacji
Typ zwracany
Azure SDK for Python
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla