BatchJobReleaseTask interface
Uma Tarefa de Liberação de Trabalho a ser executada na conclusão do Trabalho em qualquer Nó de Computação em que o Trabalho tenha sido executado. A Tarefa de Liberação de Trabalho é executada quando o Trabalho termina, devido a um dos seguintes motivos: O usuário chama a API Encerrar Trabalho ou a API Excluir Trabalho enquanto o Trabalho ainda está ativo, a restrição máxima de tempo de relógio de parede do Trabalho é atingida e o Trabalho ainda está ativo, ou a Tarefa do Gerenciador de Trabalho é concluída e o Trabalho é configurado para ser encerrado quando o Gerenciador de Trabalho é concluído. A Tarefa de Liberação de Trabalho é executada em cada Nó em que as Tarefas do Trabalho foram executadas e a Tarefa de Preparação de Trabalho executada e concluída. Se você recriar a imagem de um Nó depois que ele tiver executado a Tarefa de Preparação de Trabalho e o Trabalho terminar sem que outras Tarefas do Trabalho sejam executadas nesse Nó (e, portanto, a Tarefa de Preparação de Trabalho não será executada novamente), a Tarefa de Liberação de Trabalho não será executada nesse Nó de Computação. Se um Nó for reinicializado enquanto a Tarefa de Liberação de Trabalho ainda estiver em execução, a Tarefa de Liberação de Trabalho será executada novamente quando o Nó de Computação for iniciado. O Trabalho não é marcado como concluído até que todas as Tarefas de Liberação de Trabalho tenham sido concluídas. A Tarefa de Liberação de Trabalho é executada em segundo plano. Não ocupa uma faixa horária; ou seja, ele não conta para o limite taskSlotsPerNode especificado no Pool.
Propriedades
| command |
A linha de comandos da Tarefa de Liberação de Tarefas. A linha de comando não é executada sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se quiser tirar partido destas funcionalidades, deve invocar o shell na linha de comandos, por exemplo, usando "cmd /c MyCommand" em Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho Tarefa) ou usar a variável de ambiente Batch provided (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables). |
| container |
As definições do contentor sob o qual a Tarefa de Libertação de Tarefas é executada. Quando isto é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos Azure Batch diretórios no nó) são mapeados para o contentor, todas as variáveis do ambiente Tarefa são mapeadas para o contentor e a linha de comandos Tarefa é executada no contentor. Ficheiros produzidos no contentor fora de AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos para o disco anfitrião, o que significa que as APIs de ficheiros Batch não poderão aceder a esses ficheiros. |
| environment |
Uma lista de definições de variáveis de ambiente para a Tarefa de Libertação de Tarefas. |
| id | Uma cadeia que identifica de forma única a Tarefa de Libertação de Trabalho dentro do Trabalho. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífenes e sublinhados, e não pode conter mais de 64 caracteres. Se não especificar esta propriedade, o serviço Batch atribui um valor predefinido de 'jobrelease'. Nenhuma outra Tarefa no Trabalho pode ter o mesmo ID que a Tarefa de Libertação de Tarefas. 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 diretamente a API REST, o código de estado HTTP é 409 (Conflito). |
| max |
O tempo máximo decorrido que a Tarefa de Libertação de Tarefas pode executar num dado Nó de Computação, medido a partir do momento em que a Tarefa começa. Se a Tarefa não for concluída dentro do limite de tempo, o serviço Batch termina-a. O valor padrão é 15 minutos. Não pode especificar um tempo de pausa superior a 15 minutos. Se o fizer, o serviço Batch rejeita com um erro; se estiver a chamar diretamente a API REST, o código de estado HTTP é 400 (Pedido Mau). A duração do tempo está especificada no formato ISO 8601. |
| resource |
Uma lista de arquivos que o serviço em lote baixará para o nó de computação antes de executar a linha de comando. Há um tamanho máximo para a lista de arquivos de recursos. Quando o tamanho máximo for excedido, a solicitação falhará e o código de erro de resposta será RequestEntityTooLarge. Se isso ocorrer, a coleção de ResourceFiles deve ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker. Os arquivos listados sob este elemento estão localizados no diretório de trabalho da tarefa. |
| retention |
O tempo mínimo para manter o diretório Tarefa para a Tarefa de Lançamento de Tarefas no Nó de Computação. Após este período, o serviço Batch pode eliminar o diretório Task e todo o seu conteúdo. O padrã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 o Trabalho seja eliminado. A duração do tempo está especificada no formato ISO 8601. |
| user |
A identidade do utilizador sob a qual a Tarefa de Liberação de Tarefas é executada. Se omitida, a Tarefa é executada como um utilizador não administrativo único da Tarefa. |
Detalhes de Propriedade
commandLine
A linha de comandos da Tarefa de Liberação de Tarefas. A linha de comando não é executada sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se quiser tirar partido destas funcionalidades, deve invocar o shell na linha de comandos, por exemplo, usando "cmd /c MyCommand" em Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho Tarefa) ou usar a variável de ambiente Batch provided (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
commandLine: stringValor de Propriedade
string
containerSettings
As definições do contentor sob o qual a Tarefa de Libertação de Tarefas é executada. Quando isto é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos Azure Batch diretórios no nó) são mapeados para o contentor, todas as variáveis do ambiente Tarefa são mapeadas para o contentor e a linha de comandos Tarefa é executada no contentor. Ficheiros produzidos no contentor fora de AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos para o disco anfitrião, o que significa que as APIs de ficheiros Batch não poderão aceder a esses ficheiros.
containerSettings?: BatchTaskContainerSettingsValor de Propriedade
environmentSettings
Uma lista de definições de variáveis de ambiente para a Tarefa de Libertação de Tarefas.
environmentSettings?: EnvironmentSetting[]Valor de Propriedade
id
Uma cadeia que identifica de forma única a Tarefa de Libertação de Trabalho dentro do Trabalho. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífenes e sublinhados, e não pode conter mais de 64 caracteres. Se não especificar esta propriedade, o serviço Batch atribui um valor predefinido de 'jobrelease'. Nenhuma outra Tarefa no Trabalho pode ter o mesmo ID que a Tarefa de Libertação de Tarefas. 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 diretamente a API REST, o código de estado HTTP é 409 (Conflito).
id?: stringValor de Propriedade
string
maxWallClockTime
O tempo máximo decorrido que a Tarefa de Libertação de Tarefas pode executar num dado Nó de Computação, medido a partir do momento em que a Tarefa começa. Se a Tarefa não for concluída dentro do limite de tempo, o serviço Batch termina-a. O valor padrão é 15 minutos. Não pode especificar um tempo de pausa superior a 15 minutos. Se o fizer, o serviço Batch rejeita com um erro; se estiver a chamar diretamente a API REST, o código de estado HTTP é 400 (Pedido Mau). A duração do tempo está especificada no formato ISO 8601.
maxWallClockTime?: stringValor de Propriedade
string
resourceFiles
Uma lista de arquivos que o serviço em lote baixará para o nó de computação antes de executar a linha de comando. Há um tamanho máximo para a lista de arquivos de recursos. Quando o tamanho máximo for excedido, a solicitação falhará e o código de erro de resposta será RequestEntityTooLarge. Se isso ocorrer, a coleção de ResourceFiles deve ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker. Os arquivos listados sob este elemento estão localizados no diretório de trabalho da tarefa.
resourceFiles?: ResourceFile[]Valor de Propriedade
retentionTime
O tempo mínimo para manter o diretório Tarefa para a Tarefa de Lançamento de Tarefas no Nó de Computação. Após este período, o serviço Batch pode eliminar o diretório Task e todo o seu conteúdo. O padrã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 o Trabalho seja eliminado. A duração do tempo está especificada no formato ISO 8601.
retentionTime?: stringValor de Propriedade
string
userIdentity
A identidade do utilizador sob a qual a Tarefa de Liberação de Tarefas é executada. Se omitida, a Tarefa é executada como um utilizador não administrativo único da Tarefa.
userIdentity?: UserIdentity