JobUpdateParameter Klasse

Der Satz von Änderungen, die an einem Auftrag vorgenommen werden sollen.

Alle erforderlichen Parameter müssen aufgefüllt werden, um an Azure senden zu können.

Vererbung

Model

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)

Parameter

priority

int

Erforderlich

Die Priorität des Auftrags. Die Prioritätswerte reichen von -1.000 bis 1.000. Dabei ist -1.000 die niedrigste Priorität und 1000 die höchste Priorität. Wenn sie nicht angegeben wird, wird sie auf den Standardwert 0 festgelegt.

max_parallel_tasks

int

Erforderlich

Die maximale Anzahl von Tasks, die parallel für den Auftrag ausgeführt werden können. Der Wert von maxParallelTasks muss -1 oder größer als 0 sein, wenn angegeben. Wenn nicht angegeben, ist der Standardwert -1. Dies bedeutet, dass die Anzahl der Aufgaben, die gleichzeitig ausgeführt werden können, nicht begrenzt ist. Sie können maxParallelTasks eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde. Standardwert: -1 .

allow_task_preemption

bool

Erforderlich

Gibt an, ob Aufgaben in diesem Auftrag von anderen Aufträgen mit hoher Priorität vorzeitig entfernt werden können. Wenn der Wert auf True festgelegt ist, haben andere Aufträge mit hoher Priorität, die an das System übermittelt werden, Vorrang und können Aufgaben aus diesem Auftrag erneut in die Warteschlange stellen. Sie können die allowTaskPreemption eines Auftrags aktualisieren, nachdem er mithilfe der Updateauftrags-API erstellt wurde.

constraints

JobConstraints

Erforderlich

Die Ausführungseinschränkungen für den Auftrag. Wenn sie nicht angegeben werden, werden die Einschränkungen gelöscht.

pool_info

PoolInformation

Erforderlich

Erforderlich. Der Pool, in dem der Batch-Dienst die Aufgaben des Auftrags ausführt. Sie können den Pool für einen Auftrag nur ändern, wenn der Auftrag deaktiviert ist. Der Aufruf des Updateauftrags schlägt fehl, wenn Sie das poolInfo-Element einschließen und der Auftrag nicht deaktiviert ist. Wenn Sie eine autoPoolSpecification in poolInfo angeben, kann nur die keepAlive-Eigenschaft der autoPoolSpecification aktualisiert werden, und dann nur, wenn die autoPoolSpecification über eine poolLifetimeOption von Job verfügt (andere Auftragseigenschaften können wie normal aktualisiert werden).

metadata

list[MetadataItem]

Erforderlich

Wenn die Angabe weggelassen wird, wird der Standardwert einer leeren Liste verwendet. in der Tat werden alle vorhandenen Metadaten gelöscht.

on_all_tasks_complete

str oder OnAllTasksComplete

Erforderlich

Die Aktion, die der Batch-Dienst ausführen soll, wenn sich alle Aufgaben im Auftrag im Status Abgeschlossen befinden. Wenn nicht angegeben, wird das Vervollständigungsverhalten auf noaction festgelegt. Wenn der aktuelle Wert terminatejob ist, ist dies ein Fehler, da das Abschlussverhalten eines Auftrags möglicherweise nicht von terminatejob in noaction geändert wird. Sie dürfen den Wert von terminatejob nicht in noaction ändern. Das heißt, wenn Sie die automatische Auftragsbeendigung aktiviert haben, können Sie ihn nicht wieder deaktivieren. Wenn Sie dies versuchen, schlägt die Anforderung fehl, und Batch gibt status Code 400 (Ungültige Anforderung) und die Fehlerantwort "ungültiger Eigenschaftswert" zurück. Wenn Sie dieses Element nicht in einer PUT-Anforderung angeben, entspricht dies der Übergabe von noaction. Dies ist ein Fehler, wenn der aktuelle Wert terminatejob ist. Mögliche Werte: "noAction", "terminateJob"

Methoden

as_dict	Gibt ein Dict zurück, das mit json.dump JSONify sein kann. Bei erweiterter Verwendung kann optional ein Rückruf als Parameter verwendet werden: Key ist der Attributname, der in Python verwendet wird. Attr_desc ist ein Diktat von Metadaten. Enthält derzeit "type" mit dem Msrest-Typ und "key" mit dem RestAPI-codierten Schlüssel. Value ist der aktuelle Wert in diesem Objekt. Die zurückgegebene Zeichenfolge wird verwendet, um den Schlüssel zu serialisieren. Wenn der Rückgabetyp eine Liste ist, wird dies als hierarchische Ergebnisdikt betrachtet. Sehen Sie sich die drei Beispiele in dieser Datei an: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Wenn Sie eine XML-Serialisierung wünschen, können Sie die kwargs is_xml=True übergeben.
deserialize	Analysieren Sie eine str mithilfe der RestAPI-Syntax, und geben Sie ein Modell zurück.
enable_additional_properties_sending
from_dict	Analysieren eines Diktats mit dem angegebenen Schlüsselextraktor gibt ein Modell zurück. Berücksichtigen Sie standardmäßig Schlüsselextraktoren (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor und last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	Gibt den JSON-Code zurück, der von diesem Modell an Azure gesendet wird. Dies ist ein Alias für as_dict(full_restapi_key_transformer, keep_readonly=False). Wenn Sie eine XML-Serialisierung wünschen, können Sie die kwargs is_xml=True übergeben.
validate	Überprüfen Sie dieses Modell rekursiv, und geben Sie eine Liste von ValidationError zurück.

as_dict

Gibt ein Dict zurück, das mit json.dump JSONify sein kann.

Bei erweiterter Verwendung kann optional ein Rückruf als Parameter verwendet werden:

Key ist der Attributname, der in Python verwendet wird. Attr_desc ist ein Diktat von Metadaten. Enthält derzeit "type" mit dem Msrest-Typ und "key" mit dem RestAPI-codierten Schlüssel. Value ist der aktuelle Wert in diesem Objekt.

Die zurückgegebene Zeichenfolge wird verwendet, um den Schlüssel zu serialisieren. Wenn der Rückgabetyp eine Liste ist, wird dies als hierarchische Ergebnisdikt betrachtet.

Sehen Sie sich die drei Beispiele in dieser Datei an:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Wenn Sie eine XML-Serialisierung wünschen, können Sie die kwargs is_xml=True übergeben.

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

Parameter

key_transformer

<xref:function>

Eine Schlüsseltransformatorfunktion.

keep_readonly

Standardwert: True

Gibt zurück

Ein JSON-kompatibles Diktatobjekt

Rückgabetyp

dict

deserialize

Analysieren Sie eine str mithilfe der RestAPI-Syntax, und geben Sie ein Modell zurück.

deserialize(data, content_type=None)

Parameter

data

str

Erforderlich

Eine str-Struktur, die die RestAPI-Struktur verwendet. Standardmäßig JSON.

content_type

str

Standardwert: None

Json standardmäßig, legen Sie application/xml fest, wenn XML.

Gibt zurück

Eine instance dieses Modells

Ausnahmen

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Analysieren eines Diktats mit dem angegebenen Schlüsselextraktor gibt ein Modell zurück.

Berücksichtigen Sie standardmäßig Schlüsselextraktoren (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor und last_rest_key_case_insensitive_extractor)

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

Parameter

data

dict

Erforderlich

Ein Diktat mithilfe der RestAPI-Struktur

content_type

str

Standardwert: None

Json standardmäßig, legen Sie application/xml fest, wenn XML.

key_extractors

Standardwert: None

Gibt zurück

Eine instance dieses Modells

Ausnahmen

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Gibt den JSON-Code zurück, der von diesem Modell an Azure gesendet wird.

Dies ist ein Alias für as_dict(full_restapi_key_transformer, keep_readonly=False).

Wenn Sie eine XML-Serialisierung wünschen, können Sie die kwargs is_xml=True übergeben.

serialize(keep_readonly=False, **kwargs)

Parameter

keep_readonly

bool

Standardwert: False

Wenn Sie die schreibgeschützten Attribute serialisieren möchten

Gibt zurück

Ein JSON-kompatibles Diktatobjekt

Rückgabetyp

dict

validate

Überprüfen Sie dieses Modell rekursiv, und geben Sie eine Liste von ValidationError zurück.

validate()

Gibt zurück

Eine Liste mit Validierungsfehlern

Rückgabetyp

list