JobUpdateParameter Klas

De set wijzigingen die moeten worden aangebracht in een taak.

Alle vereiste parameters moeten worden ingevuld om naar Azure te kunnen worden verzonden.

Overname

Model

JobUpdateParameter

Constructor

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)

Parameters

priority

int

Vereist

De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, waarbij -1000 de laagste prioriteit is en 1000 de hoogste prioriteit. Als u dit weglaat, wordt deze ingesteld op de standaardwaarde 0.

max_parallel_tasks

int

Vereist

Het maximum aantal taken dat parallel voor de taak kan worden uitgevoerd. De waarde van maxParallelTasks moet -1 of groter zijn dan 0 indien opgegeven. Als u niet opgeeft, is de standaardwaarde -1, wat betekent dat er geen limiet is voor het aantal taken dat in één keer kan worden uitgevoerd. U kunt de maxParallelTasks van een taak bijwerken nadat deze is gemaakt met behulp van de API voor de updatetaak. Standaardwaarde: -1 .

allow_task_preemption

bool

Vereist

Of taken in deze taak kunnen worden afgebroken door andere taken met hoge prioriteit. Als de waarde is ingesteld op Waar, hebben andere taken met hoge prioriteit die naar het systeem worden verzonden voorrang en kunnen taken uit deze taak worden verwijderd. U kunt de allowTaskPreemption van een taak bijwerken nadat deze is gemaakt met behulp van de API voor de updatetaak.

constraints

JobConstraints

Vereist

De uitvoeringsbeperkingen voor de taak. Als u dit weglaat, worden de beperkingen gewist.

pool_info

PoolInformation

Vereist

Vereist. De pool waarop de Batch-service de taken van de taak uitvoert. U kunt de pool voor een taak alleen wijzigen als de taak is uitgeschakeld. De aanroep Taak bijwerken mislukt als u het element poolInfo opneemt en de taak niet is uitgeschakeld. Als u een autoPoolSpecification opgeeft in de poolInfo, kan alleen de eigenschap keepAlive van de autoPoolSpecification worden bijgewerkt en vervolgens alleen als de autoPoolSpecification een poolLifetimeOption of Job heeft (andere taakeigenschappen kunnen zoals normaal worden bijgewerkt).

metadata

list[MetadataItem]

Vereist

Als u dit weglaat, wordt de standaardwaarde van een lege lijst gebruikt; in feite worden alle bestaande metagegevens verwijderd.

on_all_tasks_complete

str of OnAllTasksComplete

Vereist

De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. Als u dit weglaat, wordt het voltooiingsgedrag ingesteld op geen actie. Als de huidige waarde terminatejob is, is dit een fout omdat het voltooiingsgedrag van een taak mogelijk niet wordt gewijzigd van terminatejob in noaction. U mag de waarde van terminatejob niet wijzigen in noaction. Dat wil zeggen dat wanneer u automatische taakbeëindiging hebt ingeschakeld, u deze niet meer kunt uitschakelen. Als u dit probeert te doen, mislukt de aanvraag en retourneert Batch statuscode 400 (Ongeldige aanvraag) en een foutbericht 'ongeldige eigenschapswaarde'. Als u dit element niet opgeeft in een PUT-aanvraag, komt dit overeen met het doorgeven van noaction. Dit is een fout als de huidige waarde terminatejob is. Mogelijke waarden zijn: 'noAction', 'terminateJob'

Methoden

as_dict	Retourneer een dict die JSONify kan zijn met behulp van json.dump. Geavanceerd gebruik kan eventueel een callback gebruiken als parameter: Sleutel is de kenmerknaam die wordt gebruikt in Python. Attr_desc is een dictaat van metagegevens. Bevat momenteel 'type' met het msrest-type en 'key' met de RestAPI-gecodeerde sleutel. Waarde is de huidige waarde in dit object. De geretourneerde tekenreeks wordt gebruikt om de sleutel te serialiseren. Als het retourtype een lijst is, wordt dit beschouwd als hiërarchische resultaatdicteerfunctie. Bekijk de drie voorbeelden in dit bestand: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Als u XML-serialisatie wilt, kunt u de kwargs-is_xml=True doorgeven.
deserialize	Parseert een str met behulp van de RestAPI-syntaxis en retourneer een model.
enable_additional_properties_sending
from_dict	Een dicteren met behulp van de opgegeven sleutelextractor retourneert een model. Houd standaard rekening met sleutelextracties (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor en last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	Retourneert de JSON die vanuit dit model naar Azure wordt verzonden. Dit is een alias voor as_dict(full_restapi_key_transformer, keep_readonly=False). Als u XML-serialisatie wilt, kunt u de kwargs-is_xml=True doorgeven.
validate	Valideer dit model recursief en retourneer een lijst met ValidationError.

as_dict

Retourneer een dict die JSONify kan zijn met behulp van json.dump.

Geavanceerd gebruik kan eventueel een callback gebruiken als parameter:

Sleutel is de kenmerknaam die wordt gebruikt in Python. Attr_desc is een dictaat van metagegevens. Bevat momenteel 'type' met het msrest-type en 'key' met de RestAPI-gecodeerde sleutel. Waarde is de huidige waarde in dit object.

De geretourneerde tekenreeks wordt gebruikt om de sleutel te serialiseren. Als het retourtype een lijst is, wordt dit beschouwd als hiërarchische resultaatdicteerfunctie.

Bekijk de drie voorbeelden in dit bestand:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Als u XML-serialisatie wilt, kunt u de kwargs-is_xml=True doorgeven.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Parameters

key_transformer

<xref:function>

Een sleuteltransformatorfunctie.

keep_readonly

standaardwaarde: True

Retouren

Een dict JSON-compatibel object

Retourtype

dict

deserialize

Parseert een str met behulp van de RestAPI-syntaxis en retourneer een model.

deserialize(data, content_type=None)

Parameters

data

str

Vereist

Een str met behulp van restAPI-structuur. JSON standaard.

content_type

str

standaardwaarde: None

JSON stelt standaard toepassing/xml in als XML.

Retouren

Een exemplaar van dit model

Uitzonderingen

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Een dicteren met behulp van de opgegeven sleutelextractor retourneert een model.

Houd standaard rekening met sleutelextracties (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor en last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

Parameters

data

dict

Vereist

Een dicteerfunctie met restAPI-structuur

content_type

str

standaardwaarde: None

JSON stelt standaard toepassing/xml in als XML.

key_extractors

standaardwaarde: None

Retouren

Een exemplaar van dit model

Uitzonderingen

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Retourneert de JSON die vanuit dit model naar Azure wordt verzonden.

Dit is een alias voor as_dict(full_restapi_key_transformer, keep_readonly=False).

Als u XML-serialisatie wilt, kunt u de kwargs-is_xml=True doorgeven.

serialize(keep_readonly=False, **kwargs)

Parameters

keep_readonly

bool

standaardwaarde: False

Als u de alleen-lezen kenmerken wilt serialiseren

Retouren

Een dict JSON-compatibel object

Retourtype

dict

validate

Valideer dit model recursief en retourneer een lijst met ValidationError.

validate()

Retouren

Een lijst met validatiefouten

Retourtype

list