Delen via


JobReleaseTask Klas

Een taak voor taakrelease die moet worden uitgevoerd wanneer de taak is voltooid op een rekenknooppunt waarop de taak is uitgevoerd.

De taak taak voor het vrijgeven van de taak wordt uitgevoerd wanneer de taak eindigt, vanwege een van de volgende oorzaken: de gebruiker roept de API Voor het beëindigen van de taak of de taak verwijderen aan terwijl de taak nog actief is, de maximale tijdsbeperking voor de wandklok van de taak is bereikt en de taak nog steeds actief is, of de taak jobbeheer voltooid, en de taak wordt geconfigureerd om te worden beëindigd wanneer jobbeheer is voltooid. De taak voor taakrelease wordt uitgevoerd op elk knooppunt waarop de taken van de taak zijn uitgevoerd en de taak voor het voorbereiden van de taak is uitgevoerd en voltooid. Als u een nieuwe installatiekopie van een knooppunt maakt nadat de taak voor taakvoorbereiding is uitgevoerd en de taak eindigt zonder verdere taken van de taak die op dat knooppunt wordt uitgevoerd (en de taakvoorbereidingstaak dus niet opnieuw wordt uitgevoerd), wordt de taak voor taakvrijgave niet uitgevoerd op dat rekenknooppunt. Als een knooppunt opnieuw wordt opgestart terwijl de taak voor het vrijgeven van de taak nog steeds wordt uitgevoerd, wordt de taak voor het vrijgeven van de taak opnieuw uitgevoerd wanneer het rekenknooppunt wordt gestart. De taak wordt pas als voltooid gemarkeerd als alle taakreleasetaken zijn voltooid. De taak taak voor het vrijgeven van de taak wordt op de achtergrond uitgevoerd. Het neemt geen planningssite in beslag; dat wil gezegd, het telt niet mee voor de limiet van taskSlotsPerNode die is opgegeven voor de pool.

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

Overname
JobReleaseTask

Constructor

JobReleaseTask(*, command_line: str, id: str = None, container_settings=None, resource_files=None, environment_settings=None, max_wall_clock_time=None, retention_time=None, user_identity=None, **kwargs)

Parameters

id
str
Vereist

De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. Als u deze eigenschap niet opgeeft, wijst de Batch-service een standaardwaarde toe van 'jobrelease'. Geen enkele andere taak in de taak kan dezelfde id hebben als de taak releasetaak. Als u probeert een taak met dezelfde id te verzenden, weigert de Batch-service de aanvraag met foutcode TaskIdSameAsJobReleaseTask; Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 409 (conflict).

command_line
str
Vereist

Vereist. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell in de opdrachtregel aanroepen, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel naar bestandspaden verwijst, moet deze een relatief pad gebruiken (ten opzichte van de taakwerkmap) of de door Batch opgegeven omgevingsvariabele () gebruiken.https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables

container_settings
TaskContainerSettings
Vereist

De instellingen voor de container waaronder de taak wordt uitgevoerd. Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch mappen op het knooppunt) toegewezen aan de container, worden alle taakomgevingsvariabelen toegewezen aan de container en wordt de taakopdrachtregel uitgevoerd in de container. Bestanden die zijn geproduceerd in de container buiten AZ_BATCH_NODE_ROOT_DIR worden mogelijk niet weergegeven op de hostschijf, wat betekent dat Api's van Batch-bestanden geen toegang hebben tot deze bestanden.

resource_files
list[ResourceFile]
Vereist

Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak.

environment_settings
list[EnvironmentSetting]
Vereist
max_wall_clock_time
<xref:timedelta>
Vereist
retention_time
<xref:timedelta>
Vereist

De standaardwaarde is 7 dagen, d.w.w.: de taakmap wordt zeven dagen bewaard, tenzij het rekenknooppunt wordt verwijderd of de taak wordt verwijderd.

user_identity
UserIdentity
Vereist

De gebruikersidentiteit waaronder de Taak Release-taak wordt uitgevoerd. Als u dit weglaat, wordt de taak uitgevoerd als een gebruiker zonder beheerdersrechten die uniek is voor de taak.

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

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

validate

Valideer dit model recursief en retourneer een lijst met ValidationError.

validate()

Retouren

Een lijst met validatiefouten

Retourtype