Share via


JobReleaseTask Classe

Attività versione processo da eseguire al completamento del processo in qualsiasi nodo di calcolo in cui è stato eseguito il processo.

L'attività Rilascio processi viene eseguita al termine del processo, a causa di una delle operazioni seguenti: l'utente chiama l'API Processo termina o l'API Elimina processo mentre il processo è ancora attivo, il vincolo di tempo massimo del tempo di tempo del processo viene raggiunto e il processo è ancora attivo o l'attività Job Manager completata e il processo viene configurato per terminare al termine del completamento di Job Manager. L'attività Rilascio processo viene eseguita in ogni nodo in cui le attività del processo sono state eseguite e l'attività di preparazione del processo è stata eseguita e completata. Se si esegue nuovamente un nodo dopo l'esecuzione dell'attività preparazione processi e il processo termina senza ulteriori attività del processo in esecuzione in tale nodo (e quindi l'attività preparazione processi non viene eseguita nuovamente), l'attività Di rilascio del processo non viene eseguita nel nodo di calcolo. Se un nodo viene riavviato mentre l'attività Versione processo è ancora in esecuzione, l'attività Versione processo viene eseguita nuovamente quando viene avviato il nodo di calcolo. Il processo non viene contrassegnato come completato fino a quando non sono state completate tutte le attività di rilascio del processo. L'attività Versione processo viene eseguita in background. Non occupa uno slot di pianificazione; ovvero, non conta verso il limite taskSlotsPerNode specificato nel pool.

Tutti i parametri obbligatori devono essere popolati per inviare ad Azure.

Ereditarietà
JobReleaseTask

Costruttore

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)

Parametri

id
str
Necessario

L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura e non può contenere più di 64 caratteri. Se non si specifica questa proprietà, il servizio Batch assegna un valore predefinito di 'jobrelease'. Nessun'altra attività nel processo può avere lo stesso ID dell'attività Versione processo. Se si tenta di inviare un'attività con lo stesso ID, il servizio Batch rifiuta la richiesta con codice di errore TaskIdSameAsJobReleaseTask; se si chiama direttamente l'API REST, il codice di stato HTTP è 409 (conflitto).

command_line
str
Necessario

Obbligatorio. La riga di comando non viene eseguita in una shell e pertanto non può sfruttare le funzionalità della shell, ad esempio l'espansione delle variabili di ambiente. Se si desidera sfruttare tali funzionalità, è necessario richiamare la shell nella riga di comando, ad esempio usando "cmd /c MyCommand" in Windows o "/bin/sh -c MyCommand" in Linux. Se la riga di comando fa riferimento ai percorsi di file, deve usare un percorso relativo (rispetto alla directory di lavoro attività) o usare la variabile di ambiente fornita da Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

container_settings
TaskContainerSettings
Necessario

Impostazioni per il contenitore in cui viene eseguita l'attività Rilascio processi. Quando viene specificato, tutte le directory vengono mappate in modo ricorsivo al di sotto del AZ_BATCH_NODE_ROOT_DIR (la radice delle directory di Azure Batch nel nodo) vengono mappate nel contenitore, tutte le variabili di ambiente attività vengono mappate nel contenitore e la riga di comando attività viene eseguita nel contenitore. I file generati nel contenitore all'esterno di AZ_BATCH_NODE_ROOT_DIR potrebbero non essere riflessi nel disco host, ovvero le API file batch non potranno accedere a tali file.

resource_files
list[ResourceFile]
Necessario

I file elencati in questo elemento si trovano nella directory di lavoro dell'attività.

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

Il valore predefinito è 7 giorni, ad esempio la directory attività verrà mantenuta per 7 giorni a meno che il nodo di calcolo non venga rimosso o che il processo venga eliminato.

user_identity
UserIdentity
Necessario

Identità utente in cui viene eseguita l'attività Rilascio processi. Se omesso, l'attività viene eseguita come utente non amministrativo univoco per l'attività.

Metodi

as_dict

Restituire un valore dict che può essere JSONify usando json.dump.

L'utilizzo avanzato potrebbe facoltativamente usare un callback come parametro:

La chiave è il nome dell'attributo usato in Python. Attr_desc è un dict di metadati. Attualmente contiene 'type' con il tipo msrest e 'key' con la chiave con codifica RestAPI. Il valore è il valore corrente in questo oggetto.

La stringa restituita verrà usata per serializzare la chiave. Se il tipo restituito è un elenco, viene considerato un risultato gerarchico.

Vedere i tre esempi in questo file:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.

deserialize

Analizzare uno str usando la sintassi RestAPI e restituire un modello.

enable_additional_properties_sending
from_dict

Analizzare un dict usando un estrattore chiave specificato restituisce un modello.

Per impostazione predefinita, considerare gli estrattori di chiavi (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

Restituire il codice JSON inviato ad Azure da questo modello.

Si tratta di un alias per as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False).

Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.

validate

Convalidare questo modello in modo ricorsivo e restituire un elenco di ValidationError.

as_dict

Restituire un valore dict che può essere JSONify usando json.dump.

L'utilizzo avanzato potrebbe facoltativamente usare un callback come parametro:

La chiave è il nome dell'attributo usato in Python. Attr_desc è un dict di metadati. Attualmente contiene 'type' con il tipo msrest e 'key' con la chiave con codifica RestAPI. Il valore è il valore corrente in questo oggetto.

La stringa restituita verrà usata per serializzare la chiave. Se il tipo restituito è un elenco, viene considerato un risultato gerarchico.

Vedere i tre esempi in questo file:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.

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

Parametri

key_transformer
<xref:function>

Funzione di trasformatore chiave.

keep_readonly
valore predefinito: True

Restituisce

Oggetto compatibile con JSON dict

Tipo restituito

deserialize

Analizzare uno str usando la sintassi RestAPI e restituire un modello.

deserialize(data, content_type=None)

Parametri

data
str
Necessario

Str usando la struttura RestAPI. JSON per impostazione predefinita.

content_type
str
valore predefinito: None

JSON per impostazione predefinita, impostare application/xml se XML.

Restituisce

Istanza di questo modello

Eccezioni

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Analizzare un dict usando un estrattore chiave specificato restituisce un modello.

Per impostazione predefinita, considerare gli estrattori di chiavi (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)

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

Parametri

data
dict
Necessario

Dict using RestAPI structure

content_type
str
valore predefinito: None

JSON per impostazione predefinita, impostare application/xml se XML.

key_extractors
valore predefinito: None

Restituisce

Istanza di questo modello

Eccezioni

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Restituire il codice JSON inviato ad Azure da questo modello.

Si tratta di un alias per as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False).

Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parametri

keep_readonly
bool
valore predefinito: False

Se si vuole serializzare gli attributi readonly

Restituisce

Oggetto compatibile con JSON dict

Tipo restituito

validate

Convalidare questo modello in modo ricorsivo e restituire un elenco di ValidationError.

validate()

Restituisce

Elenco di errori di convalida

Tipo restituito