CloudJob Klas
Een Azure Batch taak.
- Overname
-
CloudJob
Constructor
CloudJob(*, id: str = None, display_name: str = None, uses_task_dependencies: bool = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, previous_state=None, previous_state_transition_time=None, priority: int = None, allow_task_preemption: bool = None, max_parallel_tasks: int = -1, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, pool_info=None, on_all_tasks_complete=None, on_task_failure=None, network_configuration=None, metadata=None, execution_info=None, stats=None, **kwargs)Parameters
- id
- str
De id is hoofdletterbewaarbaar en niet hoofdlettergevoelig (dat wil dat u mogelijk geen twee id's binnen een account hebt die alleen per geval verschillen).
- display_name
- str
- uses_task_dependencies
- bool
Of taken in de taak afhankelijkheden van elkaar kunnen definiëren. De standaardwaarde is false.
- url
- str
- e_tag
- str
Dit is een ondoorzichtige tekenreeks. U kunt deze gebruiken om te detecteren of de taak tussen aanvragen is gewijzigd. Met name kunt u de ETag doorgeven bij het bijwerken van een taak om aan te geven dat uw wijzigingen alleen van kracht moeten worden als niemand anders de taak in de tussentijd heeft gewijzigd.
- last_modified
- datetime
Dit is de laatste keer dat de gegevens op taakniveau, zoals de taakstatus of prioriteit, zijn gewijzigd. Het houdt geen rekening met wijzigingen op taakniveau, zoals het toevoegen van nieuwe taken of taken die de status wijzigen.
- creation_time
- datetime
De huidige status van de taak. Mogelijke waarden zijn: 'actief', 'uitschakelen', 'uitgeschakeld', 'inschakelen', 'beëindigen', 'voltooid', 'verwijderen'
- state_transition_time
- datetime
De vorige status van de taak. Deze eigenschap is niet ingesteld als de taak de oorspronkelijke status Actief heeft. Mogelijke waarden zijn: 'actief', 'uitschakelen', 'uitgeschakeld', 'inschakelen', 'beëindigen', 'voltooid', 'verwijderen'
- previous_state_transition_time
- datetime
Deze eigenschap is niet ingesteld als de taak de oorspronkelijke status Actief heeft.
- priority
- int
De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, waarbij -1000 de laagste prioriteit is en 1000 de hoogste prioriteit. De standaardwaarde is 0.
- allow_task_preemption
- bool
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.
- max_parallel_tasks
- int
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 .
- job_manager_task
- JobManagerTask
Details van een Taakbeheertaak die moet worden gestart wanneer de taak wordt gestart.
- job_preparation_task
- JobPreparationTask
De taak voor het voorbereiden van de taak. De taak voor taakvoorbereiding is een speciale taak die op elk rekenknooppunt wordt uitgevoerd vóór een andere taak van de taak.
- job_release_task
- JobReleaseTask
De taak voor het vrijgeven van de taak. De taak voor taakrelease is een speciale taakuitvoering aan het einde van de taak op elk rekenknooppunt waarop een andere taak van de taak is uitgevoerd.
- common_environment_settings
- list[EnvironmentSetting]
Afzonderlijke taken kunnen een omgevingsinstelling die hier is opgegeven overschrijven door dezelfde instellingsnaam met een andere waarde op te geven.
- on_all_tasks_complete
- str of OnAllTasksComplete
De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. De standaardwaarde is noaction. Mogelijke waarden zijn: 'noAction', 'terminateJob'
- on_task_failure
- str of OnTaskFailure
De actie die de Batch-service moet uitvoeren wanneer een taak in de taak mislukt. Een taak wordt beschouwd als mislukt als het een failureInfo heeft. Een failureInfo wordt ingesteld als de taak wordt voltooid met een afsluitcode die niet nul is nadat het aantal nieuwe pogingen is uitgeput, of als er een fout is opgetreden bij het starten van de taak, bijvoorbeeld vanwege een fout bij het downloaden van een resourcebestand. De standaardwaarde is noaction. Mogelijke waarden zijn: 'noAction', 'performExitOptionsJobAction'
- metadata
- list[MetadataItem]
De Batch-service wijst geen betekenis toe aan metagegevens; het is uitsluitend voor het gebruik van gebruikerscode.
- stats
- JobStatistics
Statistieken over resourcegebruik voor de gehele levensduur van de taak. Deze eigenschap wordt alleen ingevuld als de CloudJob is opgehaald met een uitbreidingscomponent, waaronder het kenmerk 'stats'; anders is het null. De statistieken zijn mogelijk niet onmiddellijk beschikbaar. De Batch-service voert periodiek samengetelde statistieken uit. De typische vertraging is ongeveer 30 minuten.
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:
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
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
Retouren
Een exemplaar van dit model
Uitzonderingen
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
- key_extractors
Retouren
Een exemplaar van dit model
Uitzonderingen
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
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
Azure SDK for Python
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor