JobAddParameter Klass
Ett Azure Batch jobb att lägga till.
Alla obligatoriska parametrar måste fyllas i för att kunna skickas till Azure.
- Arv
-
JobAddParameter
Konstruktor
JobAddParameter(*, id: str, pool_info, display_name: str = None, priority: int = None, max_parallel_tasks: int = -1, allow_task_preemption: bool = None, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, on_all_tasks_complete=None, on_task_failure=None, metadata=None, uses_task_dependencies: bool = None, network_configuration=None, **kwargs)
Parametrar
- id
- str
Krävs. ID:t kan innehålla valfri kombination av alfanumeriska tecken, inklusive bindestreck och understreck, och får inte innehålla fler än 64 tecken. ID:t är skiftlägesbevarande och skiftlägesokänsligt (dvs. du kanske inte har två ID:n inom ett konto som endast skiljer sig åt från fall till fall).
- display_name
- str
Visningsnamnet behöver inte vara unikt och kan innehålla alla Unicode-tecken upp till en maximal längd på 1024.
- priority
- int
Jobbets prioritet. 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.
- 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 .
- 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.
- job_manager_task
- JobManagerTask
Information om en Job Manager-uppgift som ska startas när jobbet startas. Om jobbet inte anger någon Job Manager-aktivitet måste användaren uttryckligen lägga till Uppgifter i jobbet. 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 Manager-aktivitetens typiska syfte är att styra och/eller övervaka jobbkörning, till exempel genom att bestämma vilka ytterligare aktiviteter som ska köras, avgöra när arbetet är klart osv. (En Job Manager-aktivitet är dock inte begränsad till dessa aktiviteter – det är en fullfjädrad uppgift i systemet och utför de åtgärder som krävs för jobbet.) En Job Manager-uppgift kan till exempel ladda ned en fil som anges som en parameter, analysera innehållet i filen och skicka ytterligare uppgifter baserat på innehållet.
- job_preparation_task
- JobPreparationTask
Jobbförberedelseaktiviteten. 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. Det går inte att ange en jobbpubliceringsaktivitet utan att ange en jobbförberedelseaktivitet för jobbet. Batch-tjänsten kör jobbpubliceringsaktiviteten på noderna som har kört jobbförberedelseaktiviteten. Det primära syftet med jobbpubliceringsaktiviteten är att ångra ändringar i beräkningsnoder 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.
- 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.
- on_all_tasks_complete
- str eller OnAllTasksComplete
Åtgärden som Batch-tjänsten ska vidta när alla aktiviteter i jobbet ä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
Åtgärden som Batch-tjänsten ska vidta när en aktivitet i jobbet misslyckas. En aktivitet anses ha misslyckats om den har en failureInfo. 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"
- metadata
- list[MetadataItem]
Batch-tjänsten tilldelar ingen mening till metadata. det är endast för användning av användarkod.
- uses_task_dependencies
- bool
Om Uppgifter i jobbet kan definiera beroenden för varandra. Standardvärdet är False.
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