BatchTaskOutput interface

Pacote:

@azure-rest/batch

O lote tentará novamente Tarefas quando uma operação de recuperação for acionada em um nó. Exemplos de operações de recuperação incluem (mas não estão limitados a) quando um nó não íntegro é reinicializado ou um nó de computação desaparece devido a falha do host. As novas tentativas devido a operações de recuperação são independentes e não são contabilizadas em relação ao maxTaskRetryCount. Mesmo se maxTaskRetryCount for 0, pode ocorrer uma nova tentativa interna devido a uma operação de recuperação. Por isso, todas as tarefas devem ser idempotentes. Isso significa que as tarefas precisam tolerar ser interrompidas e reiniciadas sem causar corrupção ou dados duplicados. A prática recomendada para tarefas de longa duração é usar alguma forma de ponto de verificação.

Propriedades

affinityInfo	Uma dica de localidade que pode ser usada pelo serviço Batch para selecionar um Nó de Computação no qual iniciar a nova Tarefa.
applicationPackageReferences	Uma lista de Pacotes que o serviço de Lote implantará no Nó de Computação antes de executar a linha de comando. Os pacotes de aplicativos são baixados e implantados em um diretório compartilhado, não no diretório de trabalho Tarefa. Portanto, se um pacote referenciado já estiver no nó e estiver atualizado, ele não será baixado novamente; a cópia existente no nó de computação é usada. Se um pacote referenciado não puder ser instalado, por exemplo, porque o pacote foi excluído ou porque o download falhou, a tarefa falhará.
authenticationTokenSettings	As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço em lote. Se essa propriedade estiver definida, o serviço Batch fornecerá à Task um token de autenticação que pode ser usado para autenticar operações de serviço em Batch sem exigir uma chave de acesso de Conta. O token é fornecido através da variável de ambiente AZ_BATCH_AUTHENTICATION_TOKEN. As operações que a Tarefa pode realizar usando o token dependem das configurações. Por exemplo, uma Tarefa pode solicitar permissões de Trabalho para adicionar outras Tarefas ao Trabalho ou verificar o status do Trabalho ou de outras Tarefas sob o Trabalho.
commandLine	A linha de comando da Tarefa. Para Tarefas de várias instâncias, a linha de comando é executada como a Tarefa principal, após a Tarefa principal e todas as subtarefas terem terminado de executar a linha de comando 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 você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no 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.
containerSettings	As configurações do contêiner sob o qual a Tarefa é executada. Se o Pool que executará esta Tarefa tiver containerConfiguration definido, isso também deverá ser definido. Se o Pool que executará esta Tarefa não tiver containerConfiguration definido, isso não deverá ser definido. Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos diretórios do Lote do Azure no nó) são mapeados no contêiner, todas as variáveis de ambiente de Tarefa são mapeadas no contêiner e a linha de comando Tarefa é executada no contêiner. Os arquivos produzidos no contêiner fora de AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos no disco host, o que significa que as APIs de arquivo em lote não poderão acessar esses arquivos.
creationTime	O tempo de criação da Tarefa.
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 êxito. Se alguma dessas Tarefas falhar e esgotar suas contagens de tentativas, essa Tarefa nunca será agendada.
displayName	Um nome para 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 configurações de variáveis de ambiente para a Tarefa.
eTag	O ETag da Tarefa. Esta é uma cadeia de caracteres opaca. Você pode usá-lo para detetar se a tarefa foi alterada entre as solicitações. Em particular, você pode passar o ETag ao atualizar uma Tarefa para especificar que suas alterações devem entrar em vigor somente se ninguém mais tiver modificado a Tarefa entretanto.
executionInfo	Informações sobre a execução da Tarefa.
exitConditions	Como o serviço de lote deve responder quando a tarefa for concluída.
id	Uma cadeia de caracteres que identifica exclusivamente 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.
lastModified	A última hora modificada da Tarefa.
multiInstanceSettings	Um objeto que indica que a Tarefa é uma Tarefa de várias instâncias e contém informações sobre como executar a Tarefa de várias instâncias.
nodeInfo	Informações sobre o nó de computação no qual a tarefa foi executada.
outputFiles	Uma lista de arquivos que o serviço Batch carregará do nó de computação depois de executar a linha de comando. Para Tarefas de várias instâncias, os arquivos só serão carregados a partir do Nó de Computação no qual a Tarefa principal é executada.
previousState	O estado anterior da Tarefa. Essa propriedade não será definida se a Tarefa estiver em seu estado Ativo inicial. Valores possíveis: "ative", "preparing", "running", "completed"
previousStateTransitionTime	A hora em que a Tarefa entrou em seu estado anterior. Essa propriedade não será definida se a Tarefa estiver em seu estado Ativo inicial.
requiredSlots	O número de slots de agendamento que a Tarefa requer para ser executada. O padrão é 1. Uma Tarefa só pode ser agendada para ser executada em um nó de computação se o nó tiver slots de agendamento livres suficientes disponíveis. Para tarefas com várias instâncias, isso 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 de várias instâncias, os arquivos de recursos só serão baixados para o Nó de Computação no qual 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.
state	O estado atual da Tarefa. Valores possíveis: "ative", "preparing", "running", "completed"
stateTransitionTime	O momento em que a Tarefa entrou em seu estado atual.
stats	Estatísticas de utilização de recursos para a Tarefa.
url	A URL da tarefa.
userIdentity	A identidade do usuário sob a qual a Tarefa é executada. Se omitida, a Tarefa é executada como um usuário não administrativo exclusivo para a Tarefa.

Detalhes de Propriedade

affinityInfo

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

affinityInfo?: BatchAffinityInfoOutput

Valor de Propriedade

BatchAffinityInfoOutput

applicationPackageReferences

Uma lista de Pacotes que o serviço de Lote implantará no Nó de Computação antes de executar a linha de comando. Os pacotes de aplicativos são baixados e implantados em um diretório compartilhado, não no diretório de trabalho Tarefa. Portanto, se um pacote referenciado já estiver no nó e estiver atualizado, ele não será baixado novamente; a cópia existente no nó de computação é usada. Se um pacote referenciado não puder ser instalado, por exemplo, porque o pacote foi excluído ou porque o download falhou, a tarefa falhará.

applicationPackageReferences?: BatchApplicationPackageReferenceOutput[]

Valor de Propriedade

BatchApplicationPackageReferenceOutput[]

authenticationTokenSettings

As configurações de um token de autenticação que a Tarefa pode usar para executar operações de serviço em lote. Se essa propriedade estiver definida, o serviço Batch fornecerá à Task um token de autenticação que pode ser usado para autenticar operações de serviço em Batch sem exigir uma chave de acesso de Conta. O token é fornecido através da variável de ambiente AZ_BATCH_AUTHENTICATION_TOKEN. As operações que a Tarefa pode realizar usando o token dependem das configurações. Por exemplo, uma Tarefa pode solicitar permissões de Trabalho para adicionar outras Tarefas ao Trabalho ou verificar o status do Trabalho ou de outras Tarefas sob o Trabalho.

authenticationTokenSettings?: AuthenticationTokenSettingsOutput

Valor de Propriedade

AuthenticationTokenSettingsOutput

commandLine

A linha de comando da Tarefa. Para Tarefas de várias instâncias, a linha de comando é executada como a Tarefa principal, após a Tarefa principal e todas as subtarefas terem terminado de executar a linha de comando 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 você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no 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.

constraints?: BatchTaskConstraintsOutput

Valor de Propriedade

BatchTaskConstraintsOutput

containerSettings

As configurações do contêiner sob o qual a Tarefa é executada. Se o Pool que executará esta Tarefa tiver containerConfiguration definido, isso também deverá ser definido. Se o Pool que executará esta Tarefa não tiver containerConfiguration definido, isso não deverá ser definido. Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos diretórios do Lote do Azure no nó) são mapeados no contêiner, todas as variáveis de ambiente de Tarefa são mapeadas no contêiner e a linha de comando Tarefa é executada no contêiner. Os arquivos produzidos no contêiner fora de AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos no disco host, o que significa que as APIs de arquivo em lote não poderão acessar esses arquivos.

containerSettings?: BatchTaskContainerSettingsOutput

Valor de Propriedade

BatchTaskContainerSettingsOutput

creationTime

O tempo de criação da Tarefa.

creationTime: string

Valor de Propriedade

string

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 êxito. Se alguma dessas Tarefas falhar e esgotar suas contagens de tentativas, essa Tarefa nunca será agendada.

dependsOn?: BatchTaskDependenciesOutput

Valor de Propriedade

BatchTaskDependenciesOutput

displayName

Um nome para 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 configurações de variáveis de ambiente para a Tarefa.

environmentSettings?: EnvironmentSettingOutput[]

Valor de Propriedade

EnvironmentSettingOutput[]

eTag

O ETag da Tarefa. Esta é uma cadeia de caracteres opaca. Você pode usá-lo para detetar se a tarefa foi alterada entre as solicitações. Em particular, você pode passar o ETag ao atualizar uma Tarefa para especificar que suas alterações devem entrar em vigor somente se ninguém mais tiver modificado a Tarefa entretanto.

eTag: string

Valor de Propriedade

string

executionInfo

Informações sobre a execução da Tarefa.

executionInfo?: BatchTaskExecutionInfoOutput

Valor de Propriedade

BatchTaskExecutionInfoOutput

exitConditions

Como o serviço de lote deve responder quando a tarefa for concluída.

exitConditions?: ExitConditionsOutput

Valor de Propriedade

ExitConditionsOutput

id

Uma cadeia de caracteres que identifica exclusivamente 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.

id: string

Valor de Propriedade

string

lastModified

A última hora modificada da Tarefa.

lastModified: string

Valor de Propriedade

string

multiInstanceSettings

Um objeto que indica que a Tarefa é uma Tarefa de várias instâncias e contém informações sobre como executar a Tarefa de várias instâncias.

multiInstanceSettings?: MultiInstanceSettingsOutput

Valor de Propriedade

MultiInstanceSettingsOutput

nodeInfo

Informações sobre o nó de computação no qual a tarefa foi executada.

nodeInfo?: BatchNodeInfoOutput

Valor de Propriedade

BatchNodeInfoOutput

outputFiles

Uma lista de arquivos que o serviço Batch carregará do nó de computação depois de executar a linha de comando. Para Tarefas de várias instâncias, os arquivos só serão carregados a partir do Nó de Computação no qual a Tarefa principal é executada.

outputFiles?: OutputFileOutput[]

Valor de Propriedade

OutputFileOutput[]

previousState

O estado anterior da Tarefa. Essa propriedade não será definida se a Tarefa estiver em seu estado Ativo inicial.

Valores possíveis: "ative", "preparing", "running", "completed"

previousState?: string

Valor de Propriedade

string

previousStateTransitionTime

A hora em que a Tarefa entrou em seu estado anterior. Essa propriedade não será definida se a Tarefa estiver em seu estado Ativo inicial.

previousStateTransitionTime?: string

Valor de Propriedade

string

requiredSlots

O número de slots de agendamento que a Tarefa requer para ser executada. O padrão é 1. Uma Tarefa só pode ser agendada para ser executada em um nó de computação se o nó tiver slots de agendamento livres suficientes disponíveis. Para tarefas com várias instâncias, isso 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 de várias instâncias, os arquivos de recursos só serão baixados para o Nó de Computação no qual 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?: ResourceFileOutput[]

Valor de Propriedade

ResourceFileOutput[]

state

O estado atual da Tarefa.

Valores possíveis: "ative", "preparing", "running", "completed"

state: string

Valor de Propriedade

string

stateTransitionTime

O momento em que a Tarefa entrou em seu estado atual.

stateTransitionTime: string

Valor de Propriedade

string

stats

Estatísticas de utilização de recursos para a Tarefa.

stats?: BatchTaskStatisticsOutput

Valor de Propriedade

BatchTaskStatisticsOutput

url

A URL da tarefa.

url: string

Valor de Propriedade

string

userIdentity

A identidade do usuário sob a qual a Tarefa é executada. Se omitida, a Tarefa é executada como um usuário não administrativo exclusivo para a Tarefa.

userIdentity?: UserIdentityOutput

Valor de Propriedade

UserIdentityOutput