Partilhar via


JobReleaseTask Classe

Uma Tarefa de Lançamento de Tarefas para ser executada na Conclusão da tarefa em qualquer Nó de Computação onde a Tarefa tenha sido executada.

A Tarefa de Lançamento da Tarefa é executada quando a Tarefa termina, devido a um dos seguintes: o utilizador chama a API terminar Tarefa ou a API Eliminar Tarefa enquanto a Tarefa ainda está ativa, a restrição de tempo máximo do relógio de parede da Tarefa é atingida e a Tarefa ainda está ativa ou a Tarefa do Gestor de Tarefas concluída e a Tarefa é configurada para terminar quando o Gestor de Tarefas for concluído. A Tarefa de Lançamento da Tarefa é executada em cada Nó onde as Tarefas da Tarefa foram executadas e a Tarefa de Preparação da Tarefa foi executada e concluída. Se recriar a imagem de um Nó depois de ter executado a Tarefa de Preparação da Tarefa e a Tarefa terminar sem mais Tarefas da Tarefa em execução nesse Nó (e, por conseguinte, a Tarefa de Preparação da Tarefa não voltar a ser executada), a Tarefa de Lançamento da Tarefa não é executada nesse Nó de Computação. Se um Nó for reiniciado enquanto a Tarefa de Versão da Tarefa ainda estiver em execução, a Tarefa de Lançamento da Tarefa é executada novamente quando o Nó de Computação é iniciado. A Tarefa não é marcada como concluída até que todas as Tarefas de Lançamento da Tarefa tenham sido concluídas. A Tarefa de Lançamento da Tarefa é executada em segundo plano. Não ocupa um bloco de agendamento; ou seja, não conta para o limite taskSlotsPerNode especificado no Conjunto.

Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.

Herança
JobReleaseTask

Construtor

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)

Parâmetros

id
str
Necessário

O ID pode conter qualquer combinação de carateres alfanuméricos, incluindo hífenes e carateres de sublinhado, e não pode conter mais de 64 carateres. Se não especificar esta propriedade, o serviço Batch atribui um valor predefinido de "jobrelease". Nenhuma outra Tarefa na Tarefa pode ter o mesmo ID que a Tarefa de Lançamento da Tarefa. Se tentar submeter uma Tarefa com o mesmo ID, o serviço Batch rejeita o pedido com o código de erro TaskIdSameAsJobReleaseTask; se estiver a chamar a API REST diretamente, o código de estado HTTP é 409 (Conflito).

command_line
str
Necessário

Obrigatório. A linha de comandos não é executada numa shell e, por conseguinte, não pode tirar partido das funcionalidades da shell, como a expansão da variável de ambiente. Se quiser tirar partido destas funcionalidades, deve invocar a shell na linha de comandos, por exemplo, utilizando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comandos se referir a caminhos de ficheiro, deve utilizar um caminho relativo (relativo ao diretório de trabalho de tarefas) ou utilizar a variável de ambiente fornecido pelo Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

container_settings
TaskContainerSettings
Necessário

As definições do contentor no qual a Tarefa de Lançamento da Tarefa é executada. Quando isto é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz de Azure Batch diretórios no nó) são mapeados para o contentor, todas as variáveis de ambiente de tarefas são mapeadas para o contentor e a linha de comandos Tarefa é executada no contentor. Os ficheiros produzidos no contentor fora do AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos no disco anfitrião, o que significa que as APIs de ficheiros do Batch não conseguirão aceder a esses ficheiros.

resource_files
list[ResourceFile]
Necessário

Os ficheiros listados neste elemento estão localizados no diretório de trabalho da Tarefa.

environment_settings
list[EnvironmentSetting]
Necessário
max_wall_clock_time
<xref:timedelta>
Necessário
retention_time
<xref:timedelta>
Necessário

A predefinição é 7 dias, ou seja, o diretório Tarefa será mantido durante 7 dias, a menos que o Nó de Computação seja removido ou a Tarefa seja eliminada.

user_identity
UserIdentity
Necessário

A identidade de utilizador sob a qual a Tarefa de Lançamento da Tarefa é executada. Se for omitida, a Tarefa é executada como um utilizador não administrativo exclusivo da Tarefa.

Métodos

as_dict

Devolver um ditado que pode ser JSONify com json.dump.

Opcionalmente, a utilização avançada pode utilizar uma chamada de retorno como parâmetro:

A chave é o nome do atributo utilizado no Python. Attr_desc é um ditado dos metadados. Atualmente, contém "type" com o tipo msrest e "key" com a chave codificada RestAPI. O valor é o valor atual neste objeto.

A cadeia devolvida será utilizada para serializar a chave. Se o tipo de retorno for uma lista, isto é considerado dict de resultado hierárquico.

Veja os três exemplos neste ficheiro:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Se quiser serialização XML, pode transmitir os kwargs is_xml=True.

deserialize

Analise um str com a sintaxe RestAPI e devolva um modelo.

enable_additional_properties_sending
from_dict

Analisar um ditado com um determinado extrator de chaves devolve um modelo.

Por predefinição, considere extratores chave (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

Devolver o JSON que seria enviado para o Azure a partir deste modelo.

Este é um alias para as_dict(full_restapi_key_transformer, keep_readonly=Falso).

Se quiser serialização XML, pode transmitir os kwargs is_xml=True.

validate

Valide este modelo de forma recursiva e devolva uma lista de ValidationError.

as_dict

Devolver um ditado que pode ser JSONify com json.dump.

Opcionalmente, a utilização avançada pode utilizar uma chamada de retorno como parâmetro:

A chave é o nome do atributo utilizado no Python. Attr_desc é um ditado dos metadados. Atualmente, contém "type" com o tipo msrest e "key" com a chave codificada RestAPI. O valor é o valor atual neste objeto.

A cadeia devolvida será utilizada para serializar a chave. Se o tipo de retorno for uma lista, isto é considerado dict de resultado hierárquico.

Veja os três exemplos neste ficheiro:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Se quiser serialização XML, pode transmitir os kwargs is_xml=True.

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

Parâmetros

key_transformer
<xref:function>

Uma função de transformador de chaves.

keep_readonly
valor predefinido: True

Devoluções

Um objeto compatível com JSON de ditado

Tipo de retorno

deserialize

Analise um str com a sintaxe RestAPI e devolva um modelo.

deserialize(data, content_type=None)

Parâmetros

data
str
Necessário

Um str com a estrutura RestAPI. JSON por predefinição.

content_type
str
valor predefinido: None

JSON por predefinição, defina application/xml se XML.

Devoluções

Uma instância deste modelo

Exceções

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Analisar um ditado com um determinado extrator de chaves devolve um modelo.

Por predefinição, considere extratores chave (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)

Parâmetros

data
dict
Necessário

Um ditado com a estrutura restAPI

content_type
str
valor predefinido: None

JSON por predefinição, defina application/xml se XML.

key_extractors
valor predefinido: None

Devoluções

Uma instância deste modelo

Exceções

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Devolver o JSON que seria enviado para o Azure a partir deste modelo.

Este é um alias para as_dict(full_restapi_key_transformer, keep_readonly=Falso).

Se quiser serialização XML, pode transmitir os kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parâmetros

keep_readonly
bool
valor predefinido: False

Se quiser serializar os atributos só de leitura

Devoluções

Um objeto compatível com JSON de ditado

Tipo de retorno

validate

Valide este modelo de forma recursiva e devolva uma lista de ValidationError.

validate()

Devoluções

Uma lista de erros de validação

Tipo de retorno