BatchTaskCreateOptions interface

Pacote:

@azure/batch

Parâmetros para criar uma tarefa Azure Batch.

Propriedades

affinityInfo	Uma dica de localidade que pode ser usada pelo serviço Batch para selecionar um Nó de Computação onde iniciar a nova Tarefa.
applicationPackageReferences	Uma lista de Pacotes que o serviço Batch irá implementar no Nó de Computação antes de executar a linha de comandos. Os pacotes de aplicações são descarregados e implementados num diretório partilhado, não no diretório de trabalho Tarefa. Portanto, se um pacote referenciado já estiver no Nó e estiver atualizado, então não é descarregado novamente; a cópia existente no Nó de Computação é utilizada. Se um Pacote referenciado não puder ser instalado, por exemplo porque o pacote foi eliminado ou porque o download falhou, a Tarefa falha.
commandLine	A linha de comandos da Tarefa. Para Tarefas multi-instância, a linha de comando é executada como a Tarefa principal, depois de a Tarefa principal e todas as subtarefas terem terminado a execução da linha de comandos de coordenação. 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).
constraints	As restrições de execução que se aplicam a esta Tarefa. Se não especificar restrições, o maxTaskRetryCount é o maxTaskRetryCount especificado para o Job, o maxWallClockTime, é infinito e o retentionTime é de 7 dias.
containerSettings	As definições do contentor sob o qual a Tarefa é executada. Se o Pool que irá executar esta tarefa tiver containerConfiguration definido, isto também deve ser definido. Se o Pool que irá executar esta Tarefa não tiver containerConfiguration ativado, isto não deve estar definido. 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.
dependsOn	As Tarefas das quais esta Tarefa depende. Esta Tarefa não será agendada até que todas as Tarefas de que depende tenham sido concluídas com sucesso. Se alguma dessas Tarefas falhar e esgotar o número de retentativas, essa Tarefa nunca será agendada. Se o Job não tiver usesTaskDependencies definido como true, e este elemento estiver presente, o pedido falha com o código de erro TaskDependenciesNotSpecifiedOnJob.
displayName	Um nome de exibição para a Tarefa. O nome para exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.
environmentSettings	Uma lista de definições de variáveis de ambiente para a Tarefa.
exitConditions	Como o serviço Batch deve responder quando a Tarefa for concluída.
id	Uma cadeia que identifica de forma única a Tarefa 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. O ID preserva o caso e é insensível a maiúsculas minúsculas (ou seja, pode não ter dois IDs dentro de um Job que diferem apenas consoante o caso).
multiInstanceSettings	Um objeto que indica que a Tarefa é uma Tarefa multiinstância e contém informações sobre como executar a Tarefa multi-instância.
outputFiles	Uma lista de ficheiros que o serviço Batch irá carregar do Nó de Computação após executar a linha de comandos. Para Tarefas de múltiplas instâncias, os ficheiros só serão carregados a partir do Nó de Computação onde a Tarefa principal é executada.
requiredSlots	O número de espaços de agendamento que a Tarefa precisava para executar. O valor predefinido é 1. Uma Tarefa só pode ser agendada para correr num nó de computação se este tiver espaços de agendamento livres suficientes. Para Tarefas de múltiplas instâncias, isto deve ser 1.
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. Para Tarefas multiinstância, os ficheiros de recurso serão descarregados apenas para o Nó de Computação onde a Tarefa principal é executada. 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.
userIdentity	A identidade do utilizador sob a qual a Tarefa é executada. Se omitida, a Tarefa é executada como um utilizador não administrativo único da Tarefa.

Detalhes de Propriedade

affinityInfo

Uma dica de localidade que pode ser usada pelo serviço Batch para selecionar um Nó de Computação onde iniciar a nova Tarefa.

affinityInfo?: BatchAffinityInfo

Valor de Propriedade

BatchAffinityInfo

applicationPackageReferences

Uma lista de Pacotes que o serviço Batch irá implementar no Nó de Computação antes de executar a linha de comandos. Os pacotes de aplicações são descarregados e implementados num diretório partilhado, não no diretório de trabalho Tarefa. Portanto, se um pacote referenciado já estiver no Nó e estiver atualizado, então não é descarregado novamente; a cópia existente no Nó de Computação é utilizada. Se um Pacote referenciado não puder ser instalado, por exemplo porque o pacote foi eliminado ou porque o download falhou, a Tarefa falha.

applicationPackageReferences?: BatchApplicationPackageReference[]

Valor de Propriedade

BatchApplicationPackageReference[]

commandLine

A linha de comandos da Tarefa. Para Tarefas multi-instância, a linha de comando é executada como a Tarefa principal, depois de a Tarefa principal e todas as subtarefas terem terminado a execução da linha de comandos de coordenação. 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: string

Valor de Propriedade

string

constraints

As restrições de execução que se aplicam a esta Tarefa. Se não especificar restrições, o maxTaskRetryCount é o maxTaskRetryCount especificado para o Job, o maxWallClockTime, é infinito e o retentionTime é de 7 dias.

constraints?: BatchTaskConstraints

Valor de Propriedade

BatchTaskConstraints

containerSettings

As definições do contentor sob o qual a Tarefa é executada. Se o Pool que irá executar esta tarefa tiver containerConfiguration definido, isto também deve ser definido. Se o Pool que irá executar esta Tarefa não tiver containerConfiguration ativado, isto não deve estar definido. 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?: BatchTaskContainerSettings

Valor de Propriedade

BatchTaskContainerSettings

dependsOn

As Tarefas das quais esta Tarefa depende. Esta Tarefa não será agendada até que todas as Tarefas de que depende tenham sido concluídas com sucesso. Se alguma dessas Tarefas falhar e esgotar o número de retentativas, essa Tarefa nunca será agendada. Se o Job não tiver usesTaskDependencies definido como true, e este elemento estiver presente, o pedido falha com o código de erro TaskDependenciesNotSpecifiedOnJob.

dependsOn?: BatchTaskDependencies

Valor de Propriedade

BatchTaskDependencies

displayName

Um nome de exibição para a Tarefa. O nome para exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.

displayName?: string

Valor de Propriedade

string

environmentSettings

Uma lista de definições de variáveis de ambiente para a Tarefa.

environmentSettings?: EnvironmentSetting[]

Valor de Propriedade

EnvironmentSetting[]

exitConditions

Como o serviço Batch deve responder quando a Tarefa for concluída.

exitConditions?: ExitConditions

Valor de Propriedade

ExitConditions

id

Uma cadeia que identifica de forma única a Tarefa 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. O ID preserva o caso e é insensível a maiúsculas minúsculas (ou seja, pode não ter dois IDs dentro de um Job que diferem apenas consoante o caso).

id: string

Valor de Propriedade

string

multiInstanceSettings

Um objeto que indica que a Tarefa é uma Tarefa multiinstância e contém informações sobre como executar a Tarefa multi-instância.

multiInstanceSettings?: MultiInstanceSettings

Valor de Propriedade

MultiInstanceSettings

outputFiles

Uma lista de ficheiros que o serviço Batch irá carregar do Nó de Computação após executar a linha de comandos. Para Tarefas de múltiplas instâncias, os ficheiros só serão carregados a partir do Nó de Computação onde a Tarefa principal é executada.

outputFiles?: OutputFile[]

Valor de Propriedade

OutputFile[]

requiredSlots

O número de espaços de agendamento que a Tarefa precisava para executar. O valor predefinido é 1. Uma Tarefa só pode ser agendada para correr num nó de computação se este tiver espaços de agendamento livres suficientes. Para Tarefas de múltiplas instâncias, isto deve ser 1.

requiredSlots?: number

Valor de Propriedade

number

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. Para Tarefas multiinstância, os ficheiros de recurso serão descarregados apenas para o Nó de Computação onde a Tarefa principal é executada. 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.

resourceFiles?: ResourceFile[]

Valor de Propriedade

ResourceFile[]

userIdentity

A identidade do utilizador sob a qual a Tarefa é executada. Se omitida, a Tarefa é executada como um utilizador não administrativo único da Tarefa.

userIdentity?: UserIdentity

Valor de Propriedade

UserIdentity