Dela via


JobUpdateParameter Klass

Den uppsättning ändringar som ska göras i ett jobb.

Alla obligatoriska parametrar måste fyllas i för att kunna skickas till Azure.

Arv
JobUpdateParameter

Konstruktor

JobUpdateParameter(*, pool_info, priority: int = None, max_parallel_tasks: int = -1, allow_task_preemption: bool = None, constraints=None, metadata=None, on_all_tasks_complete=None, **kwargs)

Parametrar

priority
int
Obligatorisk

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. Om det utelämnas anges standardvärdet 0.

max_parallel_tasks
int
Obligatorisk

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
Obligatorisk

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.

constraints
JobConstraints
Obligatorisk

Körningsbegränsningarna för jobbet. Om de utelämnas rensas begränsningarna.

pool_info
PoolInformation
Obligatorisk

Krävs. Den pool där Batch-tjänsten kör jobbets uppgifter. Du kan bara ändra poolen för ett jobb när jobbet är inaktiverat. Uppdateringsjobbanropet misslyckas om du inkluderar elementet poolInfo och jobbet inte är inaktiverat. Om du anger en autoPoolSpecification i poolInfo kan endast egenskapen keepAlive för autoPoolSpecification uppdateras och sedan endast om autoPoolSpecification har en poolLifetimeOption of Job (andra jobbegenskaper kan uppdateras som vanligt).

metadata
list[MetadataItem]
Obligatorisk

Om den utelämnas tar den standardvärdet för en tom lista. i själva verket tas alla befintliga metadata bort.

on_all_tasks_complete
str eller OnAllTasksComplete
Obligatorisk

Åtgärden som Batch-tjänsten ska vidta när alla aktiviteter i jobbet är i slutfört tillstånd. Om det utelämnas anges slutförandebeteendet till noaction. Om det aktuella värdet är terminatejob är detta ett fel eftersom ett jobbs slutförandebeteende kanske inte ändras från avslutningsjobb till noaction. Du kanske inte ändrar värdet från avslutningsjobb till noaction , det vill säga när du har aktiverat automatisk jobbavslut kan du inte stänga av det igen. Om du försöker göra detta misslyckas begäran och Batch returnerar statuskoden 400 (felaktig begäran) och felmeddelandet "ogiltigt egenskapsvärde". Om du inte anger det här elementet i en PUT-begäran motsvarar det att skicka noaction. Det här är ett fel om det aktuella värdet avslutasjobb. Möjliga värden är: "noAction", "terminateJob"

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:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

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
standardvärde: True

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

data
str
Obligatorisk

En str som använder RestAPI-struktur. JSON som standard.

content_type
str
standardvärde: None

JSON som standard anger du application/xml om XML.

Returer

En instans av den här modellen

Undantag

DeserializationError if something went wrong

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

data
dict
Obligatorisk

En dikta med Hjälp av RestAPI-struktur

content_type
str
standardvärde: None

JSON som standard anger du application/xml om XML.

key_extractors
standardvärde: None

Returer

En instans av den här modellen

Undantag

DeserializationError if something went wrong

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

keep_readonly
bool
standardvärde: False

Om du vill serialisera readonly-attributen

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