JobSpecification Klass
Anger information om de jobb som ska skapas enligt ett schema.
Alla obligatoriska parametrar måste fyllas i för att kunna skickas till Azure.
- Arv
-
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)
Parametrar
- priority
- int
Prioriteten för jobb som skapats enligt det här schemat. Prioritetsvärden kan variera från -1 000 till 1 000, där -1 000 är den lägsta prioriteten och 1 000 är den högsta prioriteten. Standardvärdet är 0. Den här prioriteten används som standard för alla jobb under jobbschemat. Du kan uppdatera ett jobbs prioritet när det har skapats med hjälp av uppdateringsjobb-API:et.
- allow_task_preemption
- bool
Om aktiviteter i det här jobbet kan föregripas av andra högprioriterade jobb. Om värdet är inställt på Sant har andra jobb med hög prioritet som skickats till systemet företräde och kan skicka aktiviteter från det här jobbet igen. Du kan uppdatera ett jobbs allowTaskPreemption när det har skapats med hjälp av API:et för uppdateringsjobbet.
- max_parallel_tasks
- int
Det maximala antalet aktiviteter som kan köras parallellt för jobbet. Värdet för maxParallelTasks måste vara -1 eller större än 0 om det anges. Om det inte anges är standardvärdet -1, vilket innebär att det inte finns någon gräns för antalet aktiviteter som kan köras samtidigt. Du kan uppdatera ett jobbs maxParallelTasks när det har skapats med hjälp av API:et för uppdateringsjobbet. Standardvärde: -1 .
- display_name
- str
Namnet behöver inte vara unikt och kan innehålla alla Unicode-tecken upp till en maximal längd på 1024.
- uses_task_dependencies
- bool
Om Uppgifter i jobbet kan definiera beroenden för varandra. Standardvärdet är False.
- on_all_tasks_complete
- str eller OnAllTasksComplete
Åtgärden som Batch-tjänsten ska vidta när alla aktiviteter i ett jobb som skapats enligt det här schemat är i slutfört tillstånd. Observera att om ett jobb inte innehåller några aktiviteter anses alla aktiviteter vara slutförda. Det här alternativet används därför oftast med en Job Manager-uppgift. Om du vill använda automatisk jobbavslut utan jobbhanterare bör du först ange onAllTasksComplete till noaction och uppdatera jobbegenskaperna för att ange onAllTasksComplete att avslutajobbet när du har lagt till aktiviteter. Standardinställningen är noaction. Möjliga värden är: "noAction", "terminateJob"
- on_task_failure
- str eller OnTaskFailure
Den åtgärd som Batch-tjänsten ska vidta när en aktivitet misslyckas i ett jobb som skapats enligt det här schemat. En aktivitet anses ha misslyckats om den har misslyckats om den har ett felInfo. Ett failureInfo anges om aktiviteten slutförs med en slutkod som inte är noll när den har förbrukat antalet återförsök, eller om det uppstod ett fel när aktiviteten startades, till exempel på grund av ett fel vid nedladdning av resursfilen. Standardinställningen är noaction. Möjliga värden är: "noAction", "performExitOptionsJobAction"
- constraints
- JobConstraints
Körningsbegränsningarna för jobb som skapats enligt det här schemat.
- job_manager_task
- JobManagerTask
Information om en Job Manager-uppgift som ska startas när ett jobb startas enligt det här schemat. Om jobbet inte anger någon Job Manager-aktivitet måste användaren uttryckligen lägga till Uppgifter i jobbet med hjälp av aktivitets-API:et. Om jobbet anger en Job Manager-aktivitet skapar Batch-tjänsten Job Manager-aktiviteten när jobbet skapas och försöker schemalägga Job Manager-aktiviteten innan andra aktiviteter i jobbet schemaläggs.
- job_preparation_task
- JobPreparationTask
Jobbförberedelseaktiviteten för jobb som skapats enligt det här schemat. Om ett jobb har en jobbförberedelseaktivitet kör Batch-tjänsten jobbförberedelseaktiviteten på en nod innan du startar aktiviteter för jobbet på beräkningsnoden.
- job_release_task
- JobReleaseTask
Jobbpubliceringsaktiviteten för jobb som skapats enligt det här schemat. Det primära syftet med jobbpubliceringsaktiviteten är att ångra ändringar i noder som gjorts av jobbförberedelseaktiviteten. Exempelaktiviteter är att ta bort lokala filer eller stänga av tjänster som startades som en del av jobbförberedelserna. Det går inte att ange en jobbpubliceringsaktivitet utan att ange en jobbförberedelseaktivitet för jobbet. Batch-tjänsten kör jobbpubliceringsaktiviteten på de beräkningsnoder som har kört jobbförberedelseaktiviteten.
- common_environment_settings
- list[EnvironmentSetting]
Enskilda aktiviteter kan åsidosätta en miljöinställning som anges här genom att ange samma inställningsnamn med ett annat värde.
- pool_info
- PoolInformation
Krävs. Den pool där Batch-tjänsten kör uppgifter för jobb som skapats enligt det här schemat.
- metadata
- list[MetadataItem]
Batch-tjänsten tilldelar ingen mening till metadata. det är endast för användning av användarkod.
Metoder
as_dict |
Returnera en diktamen som kan vara JSONify med hjälp av json.dump. Avancerad användning kan också använda ett återanrop som parameter: Nyckeln är det attributnamn som används i Python. Attr_desc är en dikta av metadata. Innehåller för närvarande "typ" med msrest-typen och "nyckel" med RestAPI-kodad nyckel. Värdet är det aktuella värdet i det här objektet. Strängen som returneras används för att serialisera nyckeln. Om returtypen är en lista anses detta vara hierarkisk resultatdikt. Se de tre exemplen i den här filen:
Om du vill ha XML-serialisering kan du skicka kwargs-is_xml=True. |
deserialize |
Parsa en str med hjälp av RestAPI-syntaxen och returnera en modell. |
enable_additional_properties_sending | |
from_dict |
Parsa en diktamen med hjälp av en viss nyckelextraktor returnerar en modell. Som standard bör du överväga viktiga extraktorer (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor och last_rest_key_case_insensitive_extractor) |
is_xml_model | |
serialize |
Returnera den JSON som skulle skickas till Azure från den här modellen. Det här är ett alias för att as_dict(full_restapi_key_transformer, keep_readonly=False). Om du vill ha XML-serialisering kan du skicka kwargs-is_xml=True. |
validate |
Verifiera den här modellen rekursivt och returnera en lista över ValidationError. |
as_dict
Returnera en diktamen som kan vara JSONify med hjälp av json.dump.
Avancerad användning kan också använda ett återanrop som parameter:
Nyckeln är det attributnamn som används i Python. Attr_desc är en dikta av metadata. Innehåller för närvarande "typ" med msrest-typen och "nyckel" med RestAPI-kodad nyckel. Värdet är det aktuella värdet i det här objektet.
Strängen som returneras används för att serialisera nyckeln. Om returtypen är en lista anses detta vara hierarkisk resultatdikt.
Se de tre exemplen i den här filen:
attribute_transformer
full_restapi_key_transformer
last_restapi_key_transformer
Om du vill ha XML-serialisering kan du skicka kwargs-is_xml=True.
as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)
Parametrar
- key_transformer
- <xref:function>
En nyckeltransformatorfunktion.
- keep_readonly
Returer
Ett dict JSON-kompatibelt objekt
Returtyp
deserialize
Parsa en str med hjälp av RestAPI-syntaxen och returnera en modell.
deserialize(data, content_type=None)
Parametrar
Returer
En instans av den här modellen
Undantag
enable_additional_properties_sending
enable_additional_properties_sending()
from_dict
Parsa en diktamen med hjälp av en viss nyckelextraktor returnerar en modell.
Som standard bör du överväga viktiga extraktorer (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor och last_rest_key_case_insensitive_extractor)
from_dict(data, key_extractors=None, content_type=None)
Parametrar
- key_extractors
Returer
En instans av den här modellen
Undantag
is_xml_model
is_xml_model()
serialize
Returnera den JSON som skulle skickas till Azure från den här modellen.
Det här är ett alias för att as_dict(full_restapi_key_transformer, keep_readonly=False).
Om du vill ha XML-serialisering kan du skicka kwargs-is_xml=True.
serialize(keep_readonly=False, **kwargs)
Parametrar
Returer
Ett dict JSON-kompatibelt objekt
Returtyp
validate
Verifiera den här modellen rekursivt och returnera en lista över ValidationError.
validate()
Returer
En lista över valideringsfel
Returtyp
Azure SDK for Python
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för